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Wei-Meng Lee 是 Developer Learning Solutions 公司 (www.learn2develop.net) 的 创始 人 和 
技术 专家 ， 这 家 技术 公司 专门 从 事 最 新 移动 技术 的 培训 。Wei-Meng Lee 具有 多 年 的 培训 经 
验 ， 他 的 培训 课程 特别 强调 实践 学 习 法 。 这 种 动手 学 习 编程 的 方法 比 通过 阅读 书籍 、 教 程 
和 文档 来 理解 主题 要 容易 得 多 。 

Wei-Meng Lee 4 Beginning iOS 5 Application Development(Wrox, 2010) 和 Beginning Android 
Application Development(Wrox, 2011) 的 作者 。 读 者 可 以 通过 weimenglee@learn2develop.net 
与 他 联系 。 


技术 编辑 何 介 


Chaim Krause 是 US Army’s Command and General Staff College 学 院 的 模拟 专家 (Simulation 
Specialist)， 他 为 该 学 院 开 发 了 运行 在 多 种 平台 (从 10S 和 Android 设备 到 Windows MHE 
系统 和 Linux 服务 器) 的 各 种 各 样 的 软件 产品 ， 并 且 还 担负 其 他 一 些 工作 。Python 是 他 最 喜 
欢 的 语言 ， 但 是 他 本 人 擅长 使 用 多 种 语言 ， 比 如 使 用 Java 和 JavaScript/HTMLS/CSS 等 编写 
代码 。 很 和 位 运 ， 他 的 软件 开发 职业 生涯 是 在 Borland 开始 的 ， 当 时 他 是 Delphi 语言 的 高 级 
开发 文 持 工 程 师 。 除 了 计算 机 相关 的 工作 ，Chaim 喜欢 techno 音乐 和 dubstep 音乐 ， 以 及 
ALA AK PR AR EK Dasher 和 Minnie 玩 踏板 车 。 
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写 这 本 书 的 过 程 就 像 是 在 坐 过 山 车 。 使 用 发 布 不 久 的 软件 在 任何 时 候 都 是 一 种 巨大 的 
挑战 。 当 我 刚 开 始 创 作 这 本 书 时 ，Android 4 SDK 刚刚 发 布 ， 浏 览 文档 获取 信息 的 过 程 就 
像 是 大 海 搁 针 。 更 加 糟糕 的 是 ，Android 平板 电脑 模拟 器 很 慢 ， 很 不 稳定 ， 这 让 开发 过 程 
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领 您 进入 Android 平板 电脑 开发 的 大 门 ， 享 受 一 个 丰富 多 彩 而 又 收获 颇 丰 的 学 习 过 程 。 您 
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人 之 一 。Bob， 谢 谢 你 的 帮助 和 指导 ! 

当然 ， 不 应 该 忘记 我 的 朋友 ， 编 辑 Ami Sullivan， 和 她 一 起 工作 的 时 候 我 总 是 感到 很 
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创作 本 书 的 那 段 时 间 里 ， 他 们 无 私 地 调整 自己 的 日 程 安排 来 迁就 我 。SzeWa 在 我 为 满足 期 
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译 者 序 


Android 的 发 展 呈 现 逐 渐 加 速 的 趋势 。 从 2008 年 Google 在 VO 开发 者 大 会 上 提出 的 
Android 1.0 开始 ， 经 过 Google 进军 “甜品 业 ” 的 标志 : Android 1.5， 直 到 目前 刚刚 发 布 的 
最 新 版 Android 4.1, 短 短 4 个 年 头 不 到 , 小 机 器 人 已 经 经 历 了 十 几 个 大 小 版 本 的 成 长 历程 。 
正如 本 书 内 容 所 展现 的 那样 ， 年 初 关于 Android 3 系列 的 入 门 开 发 经 典 刚刚 付 梓 ， 现 在 这 
本 介绍 Android 4 的 升级 版 本 又 和 大 家 见面 了 , 这 无 疑 也 是 Android 社区 和 应 用 日 益 活 跃 和 
发 展 的 集中 体现 ， 众 人 拾 柴火 焰 高 。 尽 管 和 相对 封闭 的 iogS 相 比 ， 在 版 本 “碎片 ”控制 上 
由 于 其 开放 性 无 法 做 到 完全 杜绝 ， 但 也 正 因为 如 此 ， 持 续 的 新 鲜血 液 和 新 型 应 用 才能 不 断 
得 到 实践 的 机 会 和 用 户 的 最 终 检验 。Android 的 生态 系统 也 许 在 一 时 的 奏 利 水 平 上 还 无 法 
全 面 和 苹果 抗衡 ， 但 凭借 Google 的 技术 、 管 理 优势 和 以 全 世界 34 家 服务 运营 商 、 设 备 提 
供 商 为 掌 始 的 “开放 手机 联盟 ”的 广泛 覆盖 能 力 ，Android 将 会 把 越 来 越 多 的 江湖 大 哥 变 
为 传阅。 摩托 罗拉 、 诺 基 亚 、 高 通 、 三 星 这 些 传统 的 业界 大 佬 自 不 必 提 ， 仅 就 中 国境 内 的 
移动 和 联通 两 大 运营 商 先 后 加 入 联盟 ， 并 频繁 推出 Android 设备 平台 上 的 各 种 增值 应 用 ， 
就 可 想象 在 世界 最 大 的 移动 电话 用 户 国家 Android 的 前 景 。 一 组 数字 说 明了 这 一 点 : 截止 
2011 £ 9 Att, Android 系统 的 应 用 数目 已 经 达到 了 48 万 ， 而 在 智能 手机 市 场 ，Android 
系统 的 占有 率 已 经 达到 了 43%， 继 续 排 在 移动 操作 系统 首位 。 因 此 ， 对 Android 的 开发 者 
来 说 ， 现 在 首要 的 工作 与 其 说 是 技术 的 革新 和 应 用 ， 不 如 说 是 寻找 新 的 奏 利 模式 ， 把 技术 
的 优势 转化 为 春 利 的 优势 是 Android 生态 系统 富有 挑战 性 的 课题 。 和 希望 本 书 的 读者 在 
Android 的 世界 里 循序 渐进 ， 在 紧 盯 屏幕 之 余 多 思考 一 下 现实 世界 ， 因 为 那里 才 是 所 有 开 
发 工作 的 源头 和 归宿 。 

本 书 是 一 本 有 关 基 于 Android 4 手机 操作 系统 进行 应 用 程序 开发 的 入 门 读物 ， 作 者 
Wei-Meng Lee 在 移动 操作 系统 平台 的 项 目 开 发 和 培训 上 有 具有 丰富 的 实践 经 验 。 他 采用 图 文 
并 成 、 上 和 手 性 极 强 的 步 步 引 导 的 方式 将 门外汉 领 入 Android 的 天干 世界 的 同时 ， 又 为 他 们 
展示 了 较为 广阔 的 视野 ， 避 免 了 初学 者 常 弟 具有 的 只 见 树木 不 见 森 林 的 缺憾 ， 堪 称 一 大 特 
色 。 本 书 从 Android 的 发 展 沿革 讲 起 ， 通 过 对 其 中 关键 概念 深入 浅 出 的 介绍 ， 用 大 量 的 实 
例 概括 了 Android 应 用 程序 的 构成 、 表 现形 式 以 及 运行 原理 ， 为 读者 构建 了 较为 完整 的 
Android 开发 蓝图 。 在 此 基础 上 ， 引 入 了 一 些 高 级 组 件 和 功能 的 介绍 ， 为 读者 进一步 的 实 
践 和 开发 高 价值 的 应 用 指明 了 方向 ， 再 辅 以 每 章 课 后 的 练习 ， 除 了 使 读者 巩固 所 学 知识 之 
外 ， 通 篇 口语 化 的 表达 方式 也 拉 近 了 本 书 与 读者 的 距离 。 

和 早先 的 版 本 相 比 ， 本 书 所 使 用 的 Android 4.0 平台 系统 拥有 全 新 的 系统 解锁 界面 ， 小 
插件 也 进行 了 重新 设计 ， 最 特别 的 就 是 系统 的 任务 管理 器 可 以 显示 出 程序 的 缩 略 图 ， 便 于 
用 户 准 确 快 速 地 关闭 无 用 的 程序 。 总 的 来 看 ， 新 版 本 有 具有 统一 的 UI 框架 、 沟 通 与 共享 能 
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力 和 全新 的 连接 类 型 ， 全 新 的 输入 方式 及 文本 服务 ， 并 增强 了 媒体 处 理 能 力 ， 尤 其 是 在 应 

用 程序 及 内 容 安 全 性 方面 做 了 不 少 功课 ,一定 程度 上 补 齐 了 开源 平台 常见 的 短 板 ， 将 市 给 
用 户 全 新 的 体验 ， 这 对 于 开发 者 来 说 无 疑 是 凑 履 应 用 设计 新 的 契机 。 

当然 ， 由 于 是 面向 初学 者 ，Android 本 号 的 体系 结构 和 原理 并 未 过 多 介绍 ， 对 于 想 对 

此 有 更 深入 了 解 的 读者 可 以 访问 Android 社区 以 及 海量 的 互联 网 相关 资源 。 限于 译 者 水 平 ， 

译文 定 有 很 多 不 当 之 处 ， 冤 请 读者 批评 指正 。 译 者 的 博客 是 http://blog.csdn.net/charlieking, 

欢迎 大 家 一 起 交流 。 
VETE RAI 
2012 4 6 H 22 H 
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我 最 开始 玩 Android SDK 是 在 其 正式 版 本 1.0 发 布 以 前 。 那 时 ， 工 具 还 不 完善 ，SDK 

中 的 API 不 稳定 ， 文 档 也 很 缺乏 。 经 过 三 年 半 时 间 的 快速 发 展 ， 现 在 的 Android 已 经 成 为 
-个 和 iPhone 相 比 毫 不 逊色 的 强大 的 移动 操作 系统 。 由 于 经 历 过 Android 成 长 的 所 有 痛苦 ， 

我 想 现在 是 开始 学 习 Android 编程 的 最 好 时 机 一 一 API 已 经 稳定 ， 工 具 也 有 了 改善 。 但 是 
仍然 存在 一 个 挑战 : 对 许多 人 来 说 ， 入 门 仍 是 一 个 可 望 而 不 可 及 的 目标 。 这 一 挑战 在 我 脑 
海里 徘徊 许久 ， 也 成 为 我 写本 书 的 动力 ， 它 也 许可 以 给 Android 初级 程序 员 带 来 益处 ， 并 
使 他 们 能 够 逐步 编写 更 复杂 的 应 用 程序 。 但是， 对 很 多 人 来 说 学 习 Android 仍然 不 太 容 易 。 
ifj EL, Google 最 近 发 布 了 Android SDK 的 最 新 版 本 一 一 4.0, 这 是 同时 可 用 于 智能 手机 和 平 
板 电脑 的 一 个 统一 的 移动 操作 系统 。Android 4.0 SDK 包含 原来 平板 电脑 开发 人 员 可 用 的 一 
些 新 功能 ， 初 学 者 理解 这 些 新 功能 需要 付出 一 些 努力 。 

正 是 考虑 到 了 初学 者 面临 的 这 种 挑战 ， 我 决定 创作 本 书 ， 让 Android 编程 初学 者 能 够 
逐步 掌握 开发 复杂 应 用 程序 的 方法 。 

由 于 本 书 是 写 给 Android 初级 开发 人 员 的 ， 为 的 是 使 他 们 能 够 快速 上 手 ， 因 此 我 以 线 
性 方式 涵盖 了 必要 的 主题 ， 这 样 可 以 使 您 建立 起 自己 的 知识 体系 而 不 会 被 细节 淹没 。 我 采 
取 的 哲学 观点 是 : 最 好 的 学 习 方法 是 实践 一 一 因此 ， 每 一 章 的 “ 试 一 试 ” 部 分 将 首先 教 您 
如 何 构建 一 些 东西 ， 然 后 解释 其 工作 原理 。 我 利用 创作 本 书 的 机 会 对 本 书 的 上 一 版 进行 了 
修订 和 更 新 ， 加 入 了 读者 的 反馈 和 对 Android 初学 者 很 重要 的 一 些 主题 。 

尽管 Android 编程 是 一 个 宏大 的 主题 ， 但 本 书 要 实现 三 重 目 标 : 帮助 读者 从 最 基本 的 
原理 入 手 、 使 读者 理解 SDK 的 底层 架构 以 及 领会 事情 要 按 特定 方式 完成 的 原因 。 任何 一 本 
书 都 不 能 面面俱到 地 介绍 有 关 Android 编程 的 知识 ， 但 我 确信 当 您 阅读 完 此 书 (并 做 了 练习 ) 
之 后 ， 将 有 充分 的 准备 来 应 对 下 一 个 Android 编程 的 挑战 。 


本 书 读者 对 象 


本 书 针对 的 是 打算 使 用 Google 的 Android SDK 来 开发 应 用 程序 的 Android 初级 开发 人 

员 。 为 了 从 本 书 中 真正 获 益 ， 您 应 该 在 编程 方面 具有 一 些 背 景 知识 ， 并 且 至 少 熟 悉 面 向 对 

象 编程 的 概念 。 如 果 对 Java(Android 开发 所 用 的 语言 ) 一 无 所 知 ， 那 么 您 也 许 应 该 首先 学 习 

Tl Java 编程 课程 ， 或 者 阅读 有 关 Java 编程 方面 的 优秀 书籍 。 以 我 的 经 验 ， 如 果 您 已 经 

J ft C# 或 VB.NET， 学 习 Java 就 比较 轻松 : 只 要 按照 “ 试 一 试 ” 的 步骤 就 可 以 使 您 的 学 
习 过 程 顺 利 进行 。 

对 于 那些 对 所 有 编程 概念 都 一 无 所 知 的 人 来 说 ， 我 知道 开发 移动 应 用 程序 并 赚 到 钱 是 
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很 有 诱惑 力 的 。 然 而 ， 在 尝试 本 书 的 示例 之 前 ， 我 想 首 先 学 习 一 些 基 本 的 编程 知识 才 是 更 
好 的 看 手 点 。 


注意 ; 本 书 中 讨论 的 所 有 示例 均 使 用 Android SDK 4.0 版 本 编写 和 测试 。 尽管 
我 们 已 经 努力 保证 本 书 中 所 有 用 到 的 工具 都 是 最 新 的 , 但 当 您 阅读 本 书 时 , 还 
是 很 可 能 有 更 新 版 本 的 工具 可 用 。 如 果 是 这 样 ， 某 些 指 示 和 /或 屏幕 截图 会 有 
少许 不 同 。 不 过 ， 任 何 改变 都 应 是 可 控 的 。 


本 书 主要 内 容 


本 书 涵盖 了 使 用 Android SDK 进行 Android 编程 的 基本 概念 ， 共 分 为 12 章 和 3 个 附录 。 

“第 1 章 : Android 编程 入 门 ” 介 绍 了 Android 操作 系统 的 基本 概念 和 当前 发 展 状况 。 
您 可 以 了 解 Android 设备 的 各 种 功能 以 及 市 场 上 一 些 比 较 流行 的 设备 。 还 可 以 学 习 如 何 下 
载 和 安装 所 有 必需 的 工具 来 开发 Android 应 用 程序 并 在 Android 模拟 器 上 进行 测试 。 

“第 2 章 : 活动 、 健 片 和 意图 ”使 您 熟悉 Android 编程 中 的 这 三 个 最 重要 的 概念 。 活 
JARE a Android 应 用 程序 的 构建 块 。 您 将 学 习 如 何 使 用 意图 将 活动 链接 起 来 形成 一 个 
完整 的 Android 应 用 程序 。 这 是 Android 操作 系统 的 独特 特征 之 一 

“第 3 章 : Android 用 户 界面 ”介绍 了 Android 应 用 程序 的 用 户 界 面 的 不 同 组 成 部 分 。 
您 将 学 习 到 用 来 构建 应 用 程序 的 用 户 界 面 的 不 同 布局 ， 以 及 当 用 户 和 应 用 程序 交互 时 与 用 
户 界 面相 关联 的 多 种 事件 。 

“第 4 章 : 使 用 视图 设计 用 户 界面 ”介绍 了 可 用 于 构建 Android 用 户 界 面 的 各 种 基本 
WA. 该 章 将 学 习 3 组 主要 的 视图 : 基本 视图 、 选 取 器 视图 和 列表 视图 ,还 将 学 习 Android 
3.0 和 Android 4.0 中 可 用 的 特殊 碎片 。 

“第 5 章 : 使 用 视图 显示 图 片 和 菜单 ”继续 研究 视图 。 您 将 了 解 到 如 何 使 用 不 同 的 图 
像 视图 来 显示 图 像 ， 以 及 在 应 用 程序 中 显示 选项 和 上 下 文 菜单 。 该 章 最 后 将 额外 介绍 一 些 
很 酶 的 视图 ， 可 以 用 它们 来 为 您 的 应 用 程序 锦上添花 。 

“第 6 章 : 数据 持久 化 ” 教 您 如 何在 Android 应 用 程序 中 保存 或 存储 数据 。 除 了 学 习 
使 用 不 同 的 技术 来 存储 用 户 数据 外 ， 您 将 学 习 到 文件 操作 以 及 如 何 把 文件 保存 到 内 部 或 
外 部 存储 器 (SD 卡 ) 上 。 此 外 ， 还 将 学 习 到 如 何在 Android 应 用 程序 中 创建 和 使 用 SQLite 
数据 库 。 

“第 7 章 : 内 容 提供 者 ”讨论 了 在 Android 设备 的 不 同 应 用 程序 间 如 何 共享 数据 。 您 
将 学 习 如 何 使 用 内 容 提 供 者 并 自己 创建 一 个 。 

“第 8 章 : 消息 传递 ”研究 了 移动 编程 中 最 有 趣 的 两 个 主题 一 一 发 送 SMS 消息 和 电子 
邮件 。 您 将 学 习 如 何以 编程 方式 发 送 和 接收 SMS 消息 和 电子 邮件 ， 以 及 如 何 拦截 传 入 的 
SMS 消息 ， 使 内 置 的 Messaging 应 用 程序 不 能 收 到 任何 消息 。 


ais. 二 
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“第 9 章 : 基于 位 置 的 服务 ”描述 了 如 何 使 用 Google Maps 来 构建 基于 位 置 的 服务 应 
用 程序 。 您 还 将 学 习 到 如 何 获取 地 理 位 置 数据 并 在 地 图 上 显示 该 位 置 。 

“第 10 章 : 联网 ”研究 了 如 何 连接 Web 服务 器 来 下 载 数据 。 您 将 看 到 如 何在 Android 
应 用 程序 中 使 用 XML 和 ISON Web 服务 。 本 章 还 将 介绍 套 接 字 编程 ， 以 及 如 何在 Android 
中 构建 一 个 聊天 客户 端 。 

“第 11 章 : FFA Android 服务 ”将 向 您 展示 如 何 使 用 服务 来 编写 应 用 程序 。 服 务 是 i 
行 于 后 人 台 且 没有 用 户 界 和 面 的 应 用 程序 。 您 将 了 解 如 何在 一 个 单独 的 线程 中 以 异步 方式 运 
您 的 服务 ， 以 及 活动 与 之 通信 的 方法 。 

“第 12 章 : 发 布 Android 应 用 程序 ”讨论 了 您 在 准备 好 发 布 Android 应 用 程序 时 可 以 
采用 的 不 同方 法 。 您 还 将 了 解 到 在 Android Market 上 发 布 并 出 售 应 用 程序 的 必要 步骤 。 

“附录 A: 使 用 Eclipse 进行 Android FA” WERDE J Eclipse 中 的 许多 功能 。 

“附录 B: 使 用 Android 模拟 器 ”提供 了 有 关 使 用 Android 模拟 器 进行 应 用 程序 测试 

方面 的 一 些 提 示 和 技巧 。 

“附录 C: 练习 答案 ”包含 了 每 章 最 后 的 练习 的 答案 。 


本 书 结构 安排 


本 书 将 学 习 Android 编程 的 任务 分 解 为 者 干 个 更 小 的 环节 ， 使 您 能 够 在 钻研 更 高 级 的 
内 容 之 前 消化 每 一 个 主题 。 

如 果 您 对 于 Android 编程 完全 是 个 新 手 ， 那 就 首先 从 第 1 章 开 始 。 一 旦 熟悉 基本 概念 ， 
就 可 以 转 到 附录 去 阅读 更 多 有 关 Eclipse 和 Android 模拟 器 的 知识 。 当 完成 这 些 之 后 ， 可 以 
再 从 第 2 章 继续 ， 并 按部就班 地 学 习 更 高 级 的 主题 。 

本 书 一 大 特色 就 是 每 章 的 所 有 示例 代码 都 独立 于 先前 章节 所 讨论 的 内 容 。 这 样 ， 您 可 
以 灵活 地 转 入 到 所 感 兴趣 的 主题 并 按照 “ 试 一 试 ” 的 项 目 内 容 开 始 练习 。 


使 用 本 书 的 前 提 条 件 

本 书 中 的 所 有 示例 都 在 Android 模拟 器 (作为 Android SDK 的 一 部 分 ) 中 运行 。 当 然 ， 
为 了 从 本 书 中 得 到 更 多 收获 , 拥有 一 个 真实 的 Android 设备 还 是 很 有 益 的 (尽管 这 不 是 绝对 
必要 的 )。 


产 代 码 


运 
行 


在 读者 学 习 本 书 中 的 示例 时 ， 可 以 手动 输入 所 有 代码， 也 可 以 使 用 本 书 附 帝 的 源 代码 
文件 。 本 书 使 用 的 所 有 源 代 码 都 可 以 从 本 书 合 作 站 点 http://www.wrox.com/ 或 
http://www.tupwk.com.cn/ downpage 上 下 载 。 登录 到 站 点 http:/www.wrox.com/, 使 用 Search 
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工具 或 使 用 书 名 列表 就 可 以 找到 本 书 。 接 着 单 击 Download Code 链接 ， 就 可 以 获得 所 有 的 
源 代码 。 


O 注意 : 因为 很 多 书 都 有 类 似 的 书 名 ， 通 过 书号 可 以 很 容易 找到 本 书 ， 本 书 的 
EISBN 为 978-1-118-19954-1. 
在 下 载 代 码 后 ， 只 需要 用 解压 缩 软 件 对 它 进 行 解 床 缩 即 可 。 另 外 ， 也 可 以 进入 
http://www.wrox.com/dynamic/books/download.aspx 上 的 Wrox 代码 下 载 主页 , 查看 本 书 和 其 
他 Wrox 图 书 的 所 有 代码 。 


勘误 表 


尽管 我 们 已 经 尽 了 各 种 努力 来 保证 文章 或 代 人 码 中 不 出 现 错误 ， 但 是 错误 总 是 难免 的 ， 
如 果 您 在 本 书 中 找到 了 针 误 ,例如 拼写 错误 或 代码 钠 误 ， 请 告诉 我 们 ， 我 们 将 非常 感激 。 
通过 勘误 表 ， 可 以 让 其 他 读者 避免 受挫 ， 当 然 ， 这 还 有 助 于 提供 更 高 质量 的 信息 。 

要 在 网 站 上 找到 本 书 英 文 版 的 勘误 表 ， 可 以 登录 http://www.wrox.com， 通 过 Search T. 
具 或 书 名 列表 查找 本 书 ， 然后 在 本 书 的 细 目 页 面 上 ， 单 击 Book Errata 链接 。 在 这 个 页 面 上 
可 以 查看 到 Wrox 编辑 已 提交 和 烙 贴 的 所 有 勘误 项 。 完 整 的 图 书 列表 还 包括 每 本 书 的 勘误 
表 ， 网 址 是 WwWw.wrox.com/misc-pages/booklist.shtml。 

如 果 您 发 现 的 错误 在 我 们 的 勘误 表 里 还 没有 出 现 的 话 ， 请 登录 Www.wrox.com/contact/ 
techsupport.shtml 并 乞 成 那里 的 表格 ， 把 您 发 现 的 错误 发 送 给 我 们 。 我 们 会 检查 您 的 反馈 信息 ， 
如 果 正 确 ， 我 们 将 在 本 书 的 勘误 表 页 面 张贴 该 错误 消息 ， 并 在 本 书 的 后 续 版 本 加 以 修订 。 


p2p. wrox.com 


要 与 作者 和 同行 讨论 , 请 加 入 p2p.wrox.com 上 的 P2P 论坛 。 这 个 论坛 是 一 个 基于 Web 
的 系统 ， 便 于 您 张贴 与 Wrox 图 书 相关 的 消息 和 相关 技术 ， 与 其 他 读者 和 技术 用 户 交 流 心 
fj. 该 论坛 提供 了 订阅 功能 , 当 论坛 上 有 新 的 消 县 时 , 它 可 以 给 您 传送 感 兴 趣 的 论题 。Wrox 
作者 、 编 辑 和 其 他 业界 专家 以 及 读者 都 会 到 这 个 论坛 上 探讨 问题 。 

在 p2p.wrox.com 上 有 许多 不 同 的 论坛 ,它们 不 仅 有 助 于 阅读 本 书 ， 还 有 助 于 开发 目 己 
的 应 用 程序 。 要 加 入 论坛 ， 可 以 遵循 下 面 的 步骤 。 

(1) 进入 p2p.wrox.com， 单 击 Register 链接 。 

(2) 阅读 使 用 协议 ， 并 单 击 Agree 按钮 。 

(3) 填写 加 入 该 论坛 所 需要 的 信息 和 目 己 斋 望 提供 的 其 他 可 选 信息 , 单 击 Submit 按钮 。 

(4) 您 会 收 到 一 封 电子 邮件 ， 其 中 的 信息 描述 了 如 何 验证 账户 ， 完 成 加 入 过 程 。 


Lilt 


注意 ; 不 加 入 PIP 也 可 以 阅读 论坛 上 的 消息 ， 但 要 张贴 自己 的 消息 ， 就 必须 
先 加 入 该 论坛 。 


加 入 论坛 后 ， 就 可 以 张贴 新 消 县 ， 响 应 其 他 用 户 张 贴 的 消息 。 可 以 随时 在 Web 上 阅读 
消 县 。 如 果 要 让 该 网 站 给 目 己 发 送 特定 论坛 中 的 消息 ， 可 以 单 击 论坛 列表 中 该 论坛 名 劳 边 
的 Subscribe to this Forum 图 标 。 

要 想 了 解 更 多 的 有 关 论 坛 软件 的 工作 情况 ， 以 及 P2P 和 Wrox 图 书 的 许多 第 见 问 题 的 
fe, wie bd ie FAQ， 只 需要 在 任意 P2P 页 面 上 单 击 FAQ 链接 即 可 。 
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Android 编程 入 门 


本 章 将 介绍 以 下 内 容 : 

e Android 简介 

e Android 版 本 及 其 功能 集 

e Android 架构 

e 市 场 上 的 各 种 Android 设备 

e Android Market 应 用 程序 商店 

e 如 何 获得 开发 Android 应 用 程序 的 工具 和 SDK( 软 件 开 发 工具 包 ) 
e 如 何 开发 您 的 第 一 个 Android 应 用 程序 


欢迎 阅读 本 书 ! 当 我 撰写 自己 的 第 一 本 关于 Android 的 图 书 时 ， 曾 提 到 Android 取代 
J Apple 的 iPhone， 在 美国 智能 手机 市 场 中 排名 第 二 ， 仪 次 于 Research In Motion(RIM) 的 
BlackBerry。 那 本 书 付 印 后 不 入 ，comScore( 数 字 世 界 评估 的 全 球 领 先 者 ， 是 数字 世界 的 首 
选 信 息 源 ) 发 布 的 报告 称 Android 超过 了 BlackBerry， 成 为 美国 最 受 欢迎 的 智能 手机 平台 。 

几 个 月 后 ，Google 发 布 了 Android 3.0, 代号 为 Honeycomb( 蜂 并)。 在 这 个 版 本 中 ，Google 
将 重点 放 到 了 新 的 软件 开发 套件 上 ， 引 入 了 几 个 专 为 宽屏 设备 (特别 是 平板 电脑 ) 设 计 的 新 
功能 。 如 果 是 为 Android 智能 手机 开发 应 用 程序 ，Android 3.0 的 用 处 并 不 大 ， 因 为 智能 手 
机 不 文 持 它 提供 的 新 功能 。 在 Android 3.0 发 布 的 同时 ，Google 开始 开发 下 一 个 版 本 的 
Android， 致 力 于 让 它 在 智能 手机 和 平板 电脑 上 都 可 使 用 。2011 年 10 H, Google 发 布 了 
Android 4.0， 代 号 为 Ice Cream Sandwich( 冰 激 凌 三 明治 )， 本 书 将 重点 介绍 这 个 版 本 。 

本 章 将 介绍 Android 到 底 是 什么 ， 以 及 是 什么 让 开发 人 员 和 设备 制造 商都 有 如 此 大 的 
兴趣 。 您 也 将 开始 开发 您 的 第 一 个 Android 应 用 程序 ， 并 学 会 如 何 获得 必要 的 工具 并 对 其 
设置 ， 以 便 可 以 在 Android 4.0 模拟 器 上 测试 应 用 程序 。 在 本 章 结尾 ， 您 将 具备 进一步 探索 
更 尖 奖 的 技术 和 技巧 以 开发 您 的 下 一 个 杀手 级 的 Android 应 用 程序 所 需 的 基础 知识 。 
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1.1 Android 简介 


Android 是 一 球 基 于 Linux 修订 版 本 的 移动 操作 系统 。 它 最 初 是 由 同名 的 Android 有 限 
公司 作为 进入 移动 市 场 的 战略 的 一 部 分 于 2005 年 开发 的 。Google 收购 了 Android 公司 ， 
并 接管 了 它 的 开发 工作 (包括 整个 开发 团队 )。 

Google 要 求 Android 系统 是 开放 和 免费 的 。 因 此 ， 大 部 分 Android (EITE Apache License 
开源 协议 下 都 公开 了 ， 这 意味 着 任何 想 使 用 Android 的 人 都 可 以 下 载 Android 的 全 部 源 代 
码 。 此 外 ， 供 应 商 (特别 是 硬件 制造 商 ) 可 以 添加 他 们 目 己 专 有 的 Android 扩展 ， 通 过 定制 
Android 以 区 别 于 其 他 广 商 的 产品 。 这 一 简单 的 开发 模型 使 Android 非常 有 吸引 力 ， 并 因此 
引起 了 许多 供应 商 的 兴趣 。Apple 公司 iPhone 产品 的 巨大 成 功 彻 底 改变 了 智能 手机 产业 ， 
这 深 深 影响 到 了 诸如 摩托 罗拉 和 索爱 这 一 类 多 年 只 开发 目 己 的 移动 操作 系统 的 公司 。 当 
iPhone 发 布 时 ， 这 些 大 部 分 厂商 不 得 不 争 相 寻找 振兴 目 己 产 品 的 新 出 路 。 他 们 将 Android 
视 为 一 种 解决 方案 一 一 继续 设计 目 己 的 便 件 ， 同 时 将 Android 用 作 支 持 人 硬件 的 操作 系统 。 

使 用 Android 的 主要 优势 是 它 提供 了 统一 的 应 用 程序 开发 方法 。 开 发 人 员 只 需要 为 
Android 进行 开发 ， 开 发 出 的 应 用 程序 可 以 运行 在 许多 不 同 的 设备 上 ， 只 要 这 些 设备 用 的 
是 Android 系统 。 在 智能 手机 界 ， 应 用 程序 是 成 功 链 中 的 最 重要 一 环 。 因此， 为 了 应 对 已 
经 占据 大 量 应 用 程序 市 场 的 iPhone 带 来 的 巨大 冲击 ， 设 备 制 造 商 对 Android 寄予 了 厚望 。 


1.1.1 Android 版 本 


目 首次 发 布 以 来 ， Android 已 历经 了 相当 多 数量 的 更 新 版 本 。 表 1-1 列 出 了 Android 的 
不 同 版 本 及 其 相应 代号 。 
表 1-1 Android 版 本 简 史 

Android 版 本 t “号 
, 
L5 Cupcake i KJ) 
16 Donut i) 
2.0/2.1 Eclair( 长 松 饼 ) 
2.2 Froyo( 冻 酸奶 ) 
2.3 Gingerbread(2 Df) 
3.0/3.1/3.2 Honeycomb(## $) 
4.0 Ice Cream Sandwich(ZK yx = B] 38) 


2011 年 2 H, Google 发 布 了 Android 3.0,， 它 支持 宽屏 设备 ， 是 一 种 只 针对 平板 电脑 的 
版 本 。Android 3.0 的 关键 变化 包括 : 

e 针对 平板 电脑 进行 优化 的 新 用 户 界面 

e 使 用 新 的 小 组 件 的 3D Seif 
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优化 的 多 任务 功能 
新 的 Web 浏览 右 功 能 ， 例 如 标签 式 浏 览 、 表 单 目 动 填 序 、 书 签 同 步 和 隐私 浏览 


为 Android 3.0 之 前 的 版 本 编写 的 应 用 程序 在 Android 3.0 设备 上 可 以 直接 运行 ， 无 须 
修改 。 但 是 ， 使 用 了 Android 3.0 的 新 功能 编写 的 Android 3.0 平板 电脑 应 用 程序 是 不 能 在 
较 早 的 设备 上 运行 的 。 为 了 确保 Android 3.0 平板 电脑 应 用 程序 可 以 在 各 种 版 本 的 设备 上 运 
行 ， 必 须 从 编程 方面 入 手 确保 只 使 用 Android 的 特定 版 本 文 持 的 功能 。 

在 2011 年 11 H, Google 发 布 了 Android 4.0， 让 智能 手机 也 具有 了 Android 3.0 中 引 
入 的 所 有 功能 ， 并 且 还 提供 了 一 些 新 功能 ， 包 括 面部 识别 解锁 功能 、 数 据 使 用 监控 、 近 上 距 
离 通信 (Near Field Communication, NFC)=. 
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Android 功能 


鉴于 Android 的 开源 以 及 制造 商 可 对 其 目 由 定制 的 特点 , 因此 设 有 固定 的 软 便 件 配置 。 
然而 ，Android 本 身 支持 如 下 功能 : 


LN 


存储 一 一 使 用 SQLite( 轻 量 级 的 关系 数据 库 ) 进 行 数据 存储 ， 第 6 章 将 对 数据 存储 进 
行 详 细 讨 论 。 

连接 性 一 一 支持 GSMEDGE、IDEN、CDMA、EV-DO、UMTS、Bluetooth( 包 括 
A2DP 和 AVRCP). WiFi. LTE 和 WiMAX。 第 8 章 将 详细 讨论 联网 。 

消息 传递 一 一 支持 SMS 和 MMS， 也 在 第 8 章 进行 详细 探讨 。 

Web jl i os 基于 开源 的 WebKit， 并 集成 Chrome 的 V8 JavaScript 5| 5€. 
媒体 支持 一 一 支持 以 下 媒体 H.263、H.264( 在 3GP 或 MP4 容器 中 )、MPEG-4 SP, 
AMR、AMR-WB( 在 3GP 容器 中 )、AAC、HE-AAC( 在 MP4 或 3GP 容器 中 )、MP3、 
MIDI. OggVorbis. WAV. JPEG, PNG. GIF 和 BMP。 

AE AE SC § —— TIS FRASER SK. BPS. PUTER ERR EMRA 
(GPS). 

多 点 触摸 一 一 文 持 多 点 触摸 屏幕 。 

多 任务 一 一 文 持 多 任务 应 用 。 

Flash 支持 一 一 Android 2.3 支持 Flash 10.1。 

tethering 一 一 文 持 作 为 有 线 /无 线 热点 实现 Internet 连接 共享 。 


Android 架构 


为 了 理解 Android 的 工作 方式 ,可 以 参看 图 1-1, 该 图 描述 了 构成 Android 操作 系统 (OS) 
的 各 个 层 。 
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DUE 


EE BRE GS 电话 管理 器 vi 


Android 运行 时 


核心 库 


Dalvik 虚拟 机 


Linux Fy 


显示 驱动 程序 摄像 头 驱 动 程序 闪存 驱动 程序 Binder (IPC) 驱动 程序 
键盘 驱动 程序 WiFi 驱动 程序 = A SR HS 电源 管理 
图 1-1 


Android 操作 系统 大 致 可 以 在 4 个 主要 层面 上 分 为 以 下 5 个 部 分 : 

e Linux 内 核 一 一 这 是 Android 所 基于 的 核心 。 这 一 层 包 括 了 一 个 Android 设备 的 各 
种 硬件 组 件 的 所 有 低层 设备 驱动 程序 。 

e 库 一 一 包括 了 提供 Android 操作 系统 的 主要 功能 的 全 部 代码 。 例 如 ，SQLite 库 提供 
了 支持 应 用 程序 进行 数据 存储 的 数据 库 。WebKit 库 为 浏览 Web 提供 了 众多 功能 。 

e Android 运行 时 一 一 它 与 库 同 处 一 层 , 提供 了 一 组 核心 库 , 可 以 使 开发 人 员 使 用 Java 
编程 语言 来 写 Android 应 用 程序 。Android 运行 时 还 包括 Dalvik 虚拟 机 ， 这 使 得 每 
个 Android 应 用 程序 都 在 它 自己 的 进程 中 运行 , 都 拥有 一 个 自己 的 Dalvik 虚拟 机 实 
例 (Android 应 用 程序 被 编译 成 Dalvik 可 执行 文件 )。Dalvik 是 特别 为 Android 设计 ， 
并 为 内 存 和 CPU 受 限 的 电池 供电 的 移动 设备 进行 过 优化 的 专门 的 虚拟 机 。 

e 应 用 程序 框架 一 一 对 应 用 程序 开发 人 员 公 开 了 Android 操作 系统 的 各 种 功能 ， 使 他 
们 可 以 在 应 用 程序 中 使 用 这 些 功 能 。 

e 应 用 程序 一 一 在 这 个 最 顶层 中 ， 可 以 找到 Android 设备 目 列 的 应 用 程序 (例如 电话 、 
联系 人 、 浏 览 器 等 )， 以 及 可 以 从 Android Market 应 用 程序 商店 下 载 和 安装 的 应 用 
程序 。 您 所 写 的 任何 应 用 程序 都 处 于 这 一 层 。 


1.1.4 市场 上 的 Android 设备 


Android 设备 有 各 种 样式 和 大 小 。 截 至 2011 年 11 HIX, Android 操作 系统 可 以 支持 如 
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智能 手机 
e 平板 电脑 
e HS pias 
e 上 网 本 
e MP4 播放 器 
e 互联 网 电视 
而 您 目前 很 可 能 已 经 至 少 拥 有 其 中 一 种 设备 .图 1-2 (从 左 到 右 ) 展 示 了 Samsung Galaxy 
SII, Motorola Atrix 4G 和 HTC EVO 4G 智能 手机 。 


图 1-2 
制造 商都 趋 之 者 警 的 男 一 类 流行 的 设备 是 平板 电脑 。 平板 电脑 通常 有 两 种 尺寸 :7 喘 
寸 和 10 英寸 ( 指 对 角 线 长 度 )。 网 1-3 展示 了 Samsung Galaxy Tab 10.1( 左 ) 和 Asus Eee Pad 
Transformer TF101( 右 )( 二 者 都 是 10.1 英寸 的 平板 电脑 )。Samsung Galaxy 10.1 和 Asus Eee 
Pad Transfer TF101 都 使 用 Android 3 作为 操作 系统 。 


1-3 


除了 智能 手机 和 平板 电脑 外 ，Android 也 开始 出 现在 专用 设备 中 ， 如 电子 书 疯 读 需 。 
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图 1-4 展示 了 两 球 运 行 Android 操作 系 统 的 彩色 电子 书 阅 读 絮 产品 Barnes & Noble 公司 


I NOOK Color( 左 ) 和 Amazon 的 Kindle Fire( 右 )。 


图 1-4 


除了 这 些 流行 的 移动 设备 ，Android 也 正 慢 慢 进 入 到 您 的 客厅 。 珊 典 公 司 People of Lava 
开发 了 一 球 基 于 Android 的 电视 机 ， 名 为 Scandinavia， 如 图 1-5 Bum. 

Google 还 涉足 了 基于 Android 的 专 有 的 智能 电视 平台 ， 并 和 诸如 英特尔 、 索 尼 、 有 罗技 
等 公司 进行 共同 开发 。 图 1-6 展示 了 索尼 公司 的 Google 电视 。 
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图 1-5 1-6 
在 撰写 本 书 时 ，Samsung Galaxy Nexus( 见 图 1-7) 是 唯一 一 球 运 行 Android 4.0 的 设备 。 
但 是 ，Google 承诺 可 以 使 现 有 的 设备 (例如 Nexus S) 升 级 到 Android 4.0。 在 您 读 到 本 书 时 ， 
可 能 已 经 有 了 很 多 运行 Android 4.0 的 设备 。 
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图 1-7 


1.1.5 Android Market 


如 前 所 述 ， 决 定 一 个 智能 手机 平台 成 功 的 主要 因素 之 一 是 支持 它 的 应 用 程序 。 从 iPhone 
的 成 功 可 以 清楚 地 看 出 ， 应 用 程序 在 决定 一 个 新 的 平台 是 成 功 还 是 失败 方面 扮演 了 一 个 非 
常 关键 的 角色 。 此 外 ， 使 这 些 应 用 程序 能 为 广大 用 户 访 问 也 是 极为 重要 的 。 

因此 ， 在 2008 年 8 H, Google 宣布 将 在 同年 10 月 份 为 用 户 提 供 一 个 适用 于 Android 
设备 的 在 线 应 用 程序 商店 : Android Market。 使 用 预 装 于 Android 设备 上 的 Market MH FE 
序 ， 用 户 可 以 很 方便 地 把 第 三 方 应 用 程序 直接 下 载 到 他 们 的 设备 上 。 付 费 和 人 免费 的 应 用 程 
序 在 Android Market 上 都 是 受 文 持 的 ， 不 过 付费 的 应 用 程序 由 于 法 律 问 题 只 提供 给 某 些 国 
家 的 用 户 。 

同样 ， 在 一 些 国家 ， 用 户 可 以 从 Android Market 购买 付费 的 应 用 程序 , 但 开发 人 员 不 能 在 
该 国 销售 。 例如， 在 写作 本 书 时 ， 印 度 的 用 户 可 以 从 Android Market 购买 应 用 程序 ， 但 印度 的 
开发 人 员 却 不 能 在 Android Market 上 出 售 应 用 程序 。 相 及 的 情况 也 可 能 是 存在 的 例如， 韩国 
的 用 户 不 能 购买 应 用 程序 ， 但 韩国 的 开发 人 员 可 以 在 Android Market 上 出 售 应 用 程序 。 


注意 : 第 12 章 讨 论 了 更 多 有 关 Androld Market 的 ] 内 [ 以 及 如 何在 上 面 出 售 
自己 的 应 用 程序 。 


1.1.6 Android 开发 社区 


Android 迎 来 了 第 4 个 版 本 ， 它 已 经 在 世界 范围 内 形成 了 庞大 的 开发 社区 。 现 在 更 容 
易 寻 求 问题 的 解决 办 法 , 并 找到 有 类 似 想法 的 开发 人 员 来 分 享 关于 应 用 程序 的 想法 和 经 验 。 

如 果 在 进行 Android 开发 的 过 程 中 遇 到 问题 ， 可 以 到 下 面 列 出 的 开发 社区 /网 站 来 寻找 
帮助 ; 
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e Stack Overflow(www.stackoverflow.com)——Stack Overflow 是 一 个 协作 编辑 性 的 问 
答 网 站 ， 可 以 解决 开发 人 员 的 各 种 问题 。 您 过 到 的 关于 Android 的 问题 ， 很 可 能 已 
经 在 Stack Overflow 中 被 讨论 过 并 已 经 有 了 解决 方案 了 。 最 好 的 地 方 是 ， 其 他 开发 
人 员 可 以 投票 选 出 最 佳 答 案 ， 这 样 您 就 知道 哪些 答案 是 可 以 相信 的 。 

e Google Android Training(http://developer.android.com/training/index.html)——Google 
创建 了 Android Training 网 站 ， 按 主题 分 类 包含 了 许多 实用 的 课程 。 在 写作 本 书 时 ， 
这 些 课程 大 多 包含 了 实用 的 代码 片段 ， 当 Android 开发 人 员 掌 握 了 基础 后 ， 会 发 现 
这 些 代 码 十 分 有 用 。 学 习 完 本 书 介 绍 的 基础 知识 后 ， 强 烈 建 议 您 去 看 看 这 些 课程 。 

e Android Discuss(http://groups.google.com/group/android-discuss)———Android Discuss 
是 Google 通过 Google Groups 服务 管理 的 一 个 讨论 组 。 在 这 里 可 以 讨论 关于 Android 
编程 的 各 种 话题 。Google 的 Android 团队 密切 监管 者 这 个 组 ,所 以 这 是 解决 目 己 的 
疑问 和 学 习 新 技巧 的 一 个 好 地 方 。 


1.2 ”获得 所 需 工具 


既然 已 了 解 了 Android 的 概念 和 其 功能 集 ， 您 也 许 渴望 杀 自 动手 试 一 试 ， 并 开始 写 些 
应 用 程序 。 然 而 ， 在 您 写 第 一 个 应 用 程序 之 前 ， 需 要 下 载 所 需 的 工具 和 SDK. 

对 于 Android 开发 ， 可 以 使 用 Mac、Windows PC 或 Linux 机 器 。 所 有 必需 的 工具 都 
可 以 通过 网 络 免费 下 载 。 除 了 少数 需要 访问 硬件 的 例子 以 外 ， 本 书 提 供 的 大 多 数 例 子 都 可 
以 在 Android 模拟 器 中 运行 得 很 好 。 本 书 中 ， 我 将 使 用 运行 Windows 7 操作 系统 的 计算 机 
来 演示 所 有 的 代码 示例 。 如 果 您 用 的 是 Mac 或 Linux 计算 机 ， 除 了 存在 一 些 细 微 的 差别 ， 
屏幕 截图 应 该 是 很 相似 的 ， 您 应 该 可 以 上 毫 无 困难 地 按照 本 书 的 指导 来 练习 。 

那么 ， 让 我 们 开始 有 趣 的 学 习 之 旅 吧 ! 


Java JDK 

Android SDK 使 用 Java SE 开发 工具 包 (JDK)。 Ast. 如果 您 的 计算 机 上 没有 安装 IDK, 
那么 应 该 通过 www.oracle.com/technetwork/java/javase/downloads/index.html 地 址 下 载 并 在 
疗 读 下 一 小 节 前 进行 安装 ， 


1.2.1 Android SDK 


需要 下 载 的 第 一 个 、 也 是 最 重要 的 软件 自然 是 Android SDK. Android SDK 包含 了 一 
个 调试 器 、 库 、 一 个 模拟 器 、 文 档 、 示 例 代 码 和 教程 。 

可 以 从 http://developer.android.com/sdk/index.html 下 载 Android SDK， 如 图 1-8 所 示 。 

Android SDK 打包 在 一 个 zip 文件 中 。 下 载 完 成 后 ， 将 其 内 容 (android-sdk-windows 文 
件 夹 ) 解 压 到 一 个 文件 夹 中 ， 例 如 CXAndroid 4.0\。 对 于 Windows 用 户 ，Google 建议 下 载 
installer r15-windows.exe 文件 ， 它 可 以 目 动 设置 所 需 的 工具 。 下 和 而 的 步骤 将 介绍 使 用 这 种 
方法 进行 安装 的 过 程 。 
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(C] Android SDK | Android Dew: x 


€ C |© developer.android.corn/sdk/index.htrml 


Ccin23012 


developers 


Dev Guida Reference Resources 


Android SDK Starter Package 


Download the Android SDK 
Installing the SDK 
Downloadable SOK Components 
Adding $DK Components 


Android 4.0 Platform neve 
» Android 3.2 Platform 


» Android 3.1 Platform 

Android 3.0 Platform Platform Package MDS Checksum 

Andraid 2.3.4 Platform 
b Android 2.3.3 Platform | Windows andraid-sdk r14-windows zip 33846273 bytes 48d44ae4dcfcadedeG8G2 lacb53caeeBD 
» Android 2.2 Platform 


Android 2.1 Platio : 
e | installer r14-windows exe (Recommended) 33853391 bytes 4ficb329a41328c2cee2908b31aa6i6b 


SDK Tools, r44 "=w | | 
Google USB Driver. r4 Mac OS X (intel) andraid-sd« r14-macosx.zip 30428734 bytes 812887013435382de84B6f135b26a5db4 


Support Package, r4 neve 


Welcome Developers! If you are new to the Android SDK, please read the steps below, for an overview of how to set up the SDK. 


If youre already using the Android SDK, you should update to the latest tools or platform using the Android SOK and AWO 
Manager, rather than downloading a naw SDE starter package. See Adding SDK Components. 


ADT Plugin for Eclipse Linux (1385) android-sd« r14-linux.tgz 26075936 bytes 35c989T67 184 T66dc43608 13ede8ab5 


ADT 14.0.0 new! . ] 
Here's an overview of the steps you must follow to set up the Android SDK: 
Native Development Tools 


Android NOK, r&h | | MD 
Whatie ihe NDR? . Install the SUK starter package from the table above. (If you're on Windows. download the installer for help with the initial 


setup.) 


1. Prepare your development computer and ensure it meets the system requirements. 


Me ETN . Install the ADT Plugin for Eclipse (if you'll be developing in Eclipse). 


[m] "n 
OEM USB Drivers | mr 


athere mmmn -Fd 


图 1-8 


1.2.2 ZU Android SDK 工具 


下 载 了 installer rl5-windows.exe 文件 后 ， 双 击 它 开始 安装 Android LH. ft Setup 
Wizard 的 欢迎 界面 ， 单 击 Next 按钮 继续 操作 。 

如 果 计 算 机 中 没有 安装 Java， 会 看 到 如 图 1-9 所 示 的 出 错 对 话 框 。 但 是 ， 即 使 安装 了 
Java， 仍 可 能 看 到 此 错误 。 此 时 ， 单 击 Report error 按钮 ， 然 后 单 击 Next 按钮 。 

此 时 需要 指定 一 个 目标 文件 夹 来 安装 Android SDK 工具 。 输 入 目标 路 径 ( 如 图 1-10 所 
示 )， 然 后 单 击 Next 按钮 。 


& Android SDK Tools Setup i T) Android SDK Tools Setup 


Java SE Development Kit Choose Install Location 
Detect whether Java SE Development Kit is installed. | Chocee the folder in which to install Android SDK Toole. 


Java SE Development Kit (IDE) not found. Setup will instal Android SOK Toole in the following folder. To install n a different folder, cide 
Browse and select another folder, Click Next to continue. 

Android SDK relies on the Java SE Development Kit (IDK). 

Go te htip: /java.arade.com 7 Downloads > lava 5E > IOK to download and install a IDK 

before continuing. 


Mote: A Java Runtime {JRE} is nct enough to develop for Android, 


Visit java orade. com Destination Folder 


C:\Aneroid 4.0\endroid-sdk — 


IF you believe you have a TX installed and it wae nat properly recognized, please vee the 
"Report Error’ button, This wil also enable the 'Next’ button. 
Space required; 49, 78 


Space available: 563. 258 


Hullsaft Instal Syesbem »17-Ock-201 1,060 一 AA Mulsaft Install System v17-Ock-2011 cvs 


1-9 1-10 


当 向 导 要 求 选择 一 个 Start Menu 文件 夹 来 创建 程序 的 快捷 方式 时 ,选择 默认 的 Android 
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SDK Tools， 然 后 单 击 Install。 和 安装 完成 后 ， 单 击 Start SDK Manager( to download system 
images, etc.) 选 项 ， 然 后 单 击 Finish 按钮 (如 图 1-11 所 示 )。 这 将 启动 SDK Manager. 


g) Android SDK Tools Setup 


Completing the Android SDK Tools 
Setup Wizard 


Android SDK Tools has been instelled on your computer, 


Glick Finish to dose this wizard, 


Bart SOK Maneger (to dowrloed system reges, elc.) 
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1.2.3 fc Android SDK Manager 


Android SDK Manager 管理 计算 机 上 目前 安装 的 各 种 版 本 的 Android SDK. 局 动 Android 
SDK Manager 后 ， 会 看 到 一 个 项 目 列 表 ， 以 及 当前 计算 机 中 是 否 安 装 了 它们 ， 如 图 1-12 


Bran 


Android SDE Manager 

Packages Tools 

SDK Path: E\Android 4 Dancdraid-zdl 

Packages 

AFI 


Marne 


4 || LJ Tools 
F| X Android SDK Tools 
Wl et Android SDK Platform-toals 

a [V] (=) Android 4.0 (APT 14) 
EJ zl Documentation for Android SDK 
V] SDK Platform 
W| d Samples for SDK 
if] ow! ARM EABI v7a System Image 
W| Ry Google APi by Google Inc 

t [7] i] Android 3.2 (APT13) 

t [P1 8] Android 3.1 (APT12) 

t 回国 Android 3.0 (APT 11) 

t [7] iz] Android 2.3.3 (API 10) 

t 回国 Android 2.2 (API 8) 

> [7] GS Android 2.1 (APT7) 

t O Android 1.6 (API 4) 

t [E] i] Android 1.5 (API 3) 

4 [V] 加 Extras 
| Bg] Android Support package 
iV] Bal Google Admob Ads Sdk package 
|E Google Market Billing package 
| Google Market Licensing package 
F| ER) Google USB Driver package 
W| Ba) Google Webdriver package 


14 


Show: | Updates/New [W] Installed ("| Obsolete Select New/'Updates 


Sort by; @) API level (> Repository Deselect All 


Done loading packages, 


图 1-12 


Xp f B6 H A LH. AAFS. 然后 , Hr Install 按钮 下 载 它们 。 因 为 从 Google 
而 等 到 有 更 多 时 间 时 再 下 载 其 他 东 


的 服务 左下 载 需 要 一 些 时 间 ， 只 下 载 迫 切 需要 的 东西 ， 


Rev. 


Status 


c3 Installed 
4 Not installed 


Ẹ Not installed 
V. Not installed 
Ẹ Not installed 
Ẹ Not installed 
Ẹ Not installed 


Ẹ Not installed 
+ Not installed 
Ẹ Not installed 
} Not installed 
$ Not installed 
Ẹ Not installed 


Install 12 packages... 


Deete packages.. 
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西 是 一 个 好 主意 。 现 在 ， 可 以 只 选中 图 中 显示 的 项 。 


注意 ; 一 开始 ， 至 少 应 该 选中 最 新 的 Android 4.0 SDK 平台 和 Extras。 在 创作 
本 书 时 ， 最 新 的 SDK 平台 是 SDK Platform Android 4.0, API 14. 


每 个 版 本 的 Android OS 都 通过 一 个 API 级 别 号 标识 。 例 如 ，Android 2.3.3 是 级 别 10(API 
10), ify Android 3.0 是 级 别 11(API 11) 等 。 对 于 每 个 级 别 , 有 两 个 平台 可 用 , 例如 , 级别 14 
提供 了 以 下 两 个 平台 : 

e SDK Platform 

e Google 公司 的 Goopgle APIs 

两 者 的 关键 区 别 是 ，Google APIs 平台 包含 Google 提供 的 附加 API( 如 Google Maps PE). 
因此 ， 如 果 所 编写 的 应 用 程序 需要 使 用 Google Maps， 就 需要 使 用 Google APIs 平台 创建 一 
个 AVD( 第 9 章 将 详细 介绍 这 方面 的 知识 )。 

需要 选择 要 安装 的 包 ( 如 图 1-13 所 示 )。 选 中 AcceptAll 选项 ， 然 后 单 击 Install 按钮 。 

Choose Packages to Install 


Packages Package Description & License 
w Android SDK platform-tools revision 8 ,,, ^ Package Description 
v Documentation for Android SDK, API1,.. | | Android SDK Platform-tools, revision 8 


w SDK Platform Android 4.0, APT14, revisi... n 

Me | Dependencies 
^ Samples for SDK API 14, reviSmm 1 | This packa ge ls a dependency for 
v ARM EABI v7a System Image, Android... |E || - Android SDK Tools, revision 14 
“ Google APIs by Google Inc., Android A... 
| a Archive Description 
~ Android Support package, revision 4 Archive for Windows 
w" Google Admob Ads Sdk package, revisi... Size: 9.1 MiB | 


« Google Market Billing package, revisio... SHAI: ad1f47979468331c463549e4edb757 e676e3d67a 


w" Google Market Licensing package, revi... 
DEAE = DCD Mren m= ee eee A B ] * Accept s Reject 


图 1-13 


SDK Manager 将 继续 下 载 选 中 的 包 。 安 闭 过 程 需 要 一 些 时 间 ， 所 以 要 保持 耐心 。 所 有 
的 包 安 闭 完 成 后 ， 会 要 求 重 让 ADB(Android Debug Bridge). "Eit; Yes 按钮 。 


1.2.4 Eclipse 


下 一 步 是 获得 Android 应 用 程序 开发 的 集成 开发 环境 GDE)。 就 Android 来 说 ， 推 荐 使 
用 Eclipse。. 它 是 一 个 多 语言 的 软件 开发 环境 ,有 一 个 可 扩展 的 插件 系统 ,通过 它 可 以 用 Javas 
Ada, C, C++, COBOL, Python 等 语言 开发 各 种 类 型 的 应 用 程序 。 

对 于 Android 的 开发 ， 要 下 载 Eclipse IDE for Java EE Developers (www.eclipse.org/ 
downloads). 目前 有 6 个 版 本 可 用 : Windows(32 位 和 64 位 )、 Mac OS X (Cocoa 32 和 64) 以 
及 Linux (32 位 和 64 位 )。 只 要 选择 与 您 的 操作 系统 相对 应 的 那个 版 本 进行 安装 即 可 。 本 书 


11 


12 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


所 有 示例 均 使 用 Windows 平台 下 的 32 位 版 本 的 Eclipse 进行 过 测试 。 
‘Fa Eclipse IDE 后 ， 把 其 内 容 (eclipse 文件 夹 ) 解 压 到 一 个 文件 

夹 下 ， 比 如 Ci\Android 4.0\。 图 1-14 显示 了 eclipse 文件 夹 的 内 容 。 
要 启动 Eclipse， 可 以 双击 eclipse.exe 文件 。 这 时 系统 会 要 求 指定 

TAEK. Eclipse 中 的 工作 区 就 是 存储 所 有 项 目的 一 个 文件 来。 接受 建 

议 的 默认 工作 区 (也 可 以 指定 自己 的 文件 夹 作为 工作 区 ), 然后 单 击 OK 

按钮 。 B 


1.25 Android 开发 工具 


启动 Eclipse 后 ,选择 Help | Install New Software 菜单 项 (如 图 1-15 
所 示 ) 来 安装 Eclipse 的 Android Development Tools(ADT) 插 件 。 


= Edit Navigate Search Project Run Window [ Help | 


£xj Welcome oa ‘ie | Welcome 


Eclipse Java EE IDE for Web Developers | Hp Contents 
Sear 


图 1-15 


ADT 是 对 Eclipse IDE 的 扩展 ， 用 以 支持 Android 应 用 程序 的 创建 和 调试 。 使 用 ADT, 
可 以 在 Eclipse 中 做 如 下 工作 : 

e 创建 新 的 Android 应 用 程序 项 目 

e 访问 Android 模拟 器 和 设备 的 存 取 工 具 
编译 和 调试 Android 应 用 程序 
e 将 Android 应 用 程序 导出 到 Android 包 (APK) 
创建 数字 证 书 来 对 APK 进行 代码 签名 

在 出 现 的 Install 窗口 中 的 文本 框 内 输入 https://dl-ssl.google.com/android/eclipse/， 然 后 
4% Enter 键 。 稍 后 ， 您 将 看 到 在 窗口 的 正中 央 显 示 出 Developer Tools 项 (如 图 1-16 所 示 )。 
展开 后 ， 显 示 出 以 下 内 容 : Android DDMS、Android Development Tools、Android Hierarchy 
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Viewer 和 Android Traceview。 全 选 并 单 击 Next 按钮 两 次 。 


fe Install 


Available Software 
Check the items that you wish to install, 


Work with: — httpz//di-ssl.qonglg com/android/ecligse/ * | Add... | 


Find more software by working with the "Available Software Sites" preferences. 
type Filter text 


Mame Merzipn 

4 [| 00 Developer Tools 
[9] 4$. Android DOMS 14.0.0 2011101 71935 -205994 
页 上 Android Development Tools 14.0.0.v2011101 71835-205884 
beck Android Hierarchy Viewer 14.0.0 a 1101 PL SS5-205 992 
EJ] r Android T raceview 14.D.0 2011101 71935-2059804 


Deselect All 4 items selected 


Details 


[4| Show only the latest versions of available software | Hide items that are already installed 
[4] Group items by category What is already installed? 
[| Show only software applicable to target environment 


[4] Contact all update sites during install to find required software 


图 1-16 


注意 : 如 果 在 下 载 ADT WHEYP SETA, "DAE http://developer.android. 
com/sdk/eclipse-adt.html#installing 上 查找 Google 的 帮助 。 


您 会 被 要 求 查看 并 接受 工具 的 许可 证 。 选 中 I accept the terms of the license agreements 
选项 并 单 击 Finish 按钮 。ADT 安装 完毕 后 ， 将 会 提示 您 重 局 Eclipse， 重 局 它 即 可 。 

重启 后 , 将 提示 您 配置 Android SDK, 如 图 1-17 Prax. 因此 前 一 节 已 经 下 载 了 Android 
SDK， 所 以 选中 Use existing SDKs 选项 ， 并 指定 Android SDK 的 安装 路 径 。 单 击 Next 按钮 。 


48; Welcome to Android Development |= | [2] [mm 
Welcome to Android Development d > " 
Configure SOK | 


To develop for Android, you need an Android SDE, and at least one version of the Android APIs to compile 
against, You may also want additional versions of Android to test with. 


|» Install new SDK 
[v] Install the latest available version of Android AFTs [supports all the latest Features) 
[Install Android 2.1, a version which is supported by «97% phones and tablets 
(You can add additional plattonns using the SDK Manager.) 


Target Locatiom | Ca Usera Wei- Meng Lee\android-sdks 


e Use existing SDKs 


Existing Location: ©:\Android 1 Osandroid-sdk 


图 1-17 
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完成 这 一 步 后 , 将 询问 是 否 把 使 用 数据 发 送 给 Google. 做 出 选择 后 , 单 击 Finish 按钮 。 


注意 : 每 个 新 版 本 的 SDK 发 布 时 ， 安 装 步骤 都 稍 有 变化 。 如 果 您 发 现 安装 步 
又 与 这 里 的 介绍 不 同 ， 也 不 用 担心 ， 只 要 按照 屏幕 上 的 提示 进行 操作 即 可 . 


1.2.6 ”创建 Android 虚拟 设备 (AVD) 


下 一 步 是 创建 用 于 测试 Android 应 用 程序 的 AVD. AVD 表示 Android 虚拟 设备 (Android 
Virtual Device). AVD 是 一 个 模拟 器 实例 ， 可 以 用 来 模拟 一 个 真实 的 设备 。 每 一 个 AVD 包 
含 一 个 便 件 配置 文件 、 一 个 到 系统 映像 的 映射 ， 以 及 模拟 存储 右 ( 例 如 安全 数字 (SD) 卡 )。 

您 打算 测试 多 少 个 不 同 配置 的 应 用 程序 ， 就 可 以 创建 多 少 个 AVD。 这 种 测试 对 于 确定 
应 用 程序 在 有 者 不 同 功能 的 不 同 设 备 上 运行 时 的 行为 是 很 重要 的 。 


注意 ,附录 B 将 讨论 Android 模拟 器 的 部 分 功能 . 


为 了 创建 AVD， 选 择 Window | AVD Manager, WWI 1-18 所 示 。 


dB] lava EE - Eclipse 

File Edit Refactor Run Navigate Search Project Help 
1 z Pew Vin dew 
Mew Editor 
Show Toolbar 
Open Perspective 
Show View 


Samples 


Customize Persoectve... 
Save Perspective As. 
Reset Perspective, 


Workbench 人 JDT 
The following samples demonstrate how to ti Close All Perspectives The following samples demonstrate how to plug into the Java 
Eclipse workbench. Development Tooling. 

Navigation Li 


© | Multi-page editor 了 < » Java editor 
` Shows how to create an editor with 图 AVD Manager Demonstrates standard features available to custom text 
eae 5 
Web Browser 
— | Property sheet and outline Ses 
B Demonstrates how to use property sheet and outline views | 
Run SWT samples us un ANC er the standalone SWT launcher or as an | 
integrated workbench v | 


| Readme tool e workbench views and standalone applications 


Shows how ta create your own extension points The SWT Example launcher will allow you te launch a 
mesial id ak examples, Some of the E can ns 
platform and others will b 
able as vie lema naide ihe EID EE. 


图 1-18 


ft Android Virtual Device Manager 对 话 框 (如 图 1-19 所 示 ) 中 ， 单 击 New… 按 钮 来 创建 
一 个 新 的 AVD。 

在 Create new Android Virtual Device(AVD) 窗 口中 , 输入 如 图 1-20 所 示 的 各 项 内 容 。 完 
成 后 单 击 Create AVD 按钮 。 
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T Android Virtual Device Manager 


| List of existing Android Virtual Devices located at Cà Users Wer-Meng Lee\.android\avd 


| AND Mame Target Name Platform APT Level 


CPU/ABI 
No AYD available 


| Refresh | 


se A valid Android Virtual Device. 22 A repairable Android Virtual Device. 
An Android Virtual Device that failed to load, Click 'Details' to see the error, 


图 1-19 


u Create new Android Virtual Device (AVD) 


Mame: Android 4.0 i 
CPU ABI: | 
SD Card: 
(@) Size: 10 
(File | 


Snapshot 
|| Enabled 


(& Built-in: Default (WVGAS00) 区 


© Resolution: m T 7 | 


Hardware 


Property 


Abstracted LCD density 
Max VM application hea... 
Device ram size 


(Det 


| | Override the existing AVD with the same name 


图 1-20 


在 这 里 ， 您 已 经 创建 了 一 个 AVD( 简 言 之， 一 个 Android 模拟 器 )， 可 以 用 来 模拟 运行 
4.0 版 本 操作 系统 且 内 置 了 10-MB SD 卡 的 Android 设备 。 除 了 所 创建 的 AVD 之 外 ， 还 可 
以 选择 模拟 具有 不 同 屏幕 像 勾 密度 和 分 辩 率 的 设备 。 


注意 : 附录 B 介绍 了 如 何 模拟 不 同类 型 的 Android 设备 ， 
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创建 一 些 具 有 不 同 API 级 别 和 硬件 配置 的 AVD 会 更 好 些 ， 这 样 您 的 应 用 程序 可 以 在 
不 同 版 本 的 Android OS 上 得 到 测试 。 


创建 了 ADV 以 后 ， 就 应 该 测试 它 。 选择 想 要 测试 的 AVD， 然 后 单 击 Start… 按 钮 。Launch 


Options 对 话 框 将 会 显示 ， 如 图 1-21 所 示 。 如 果 显 示 器 较 小 ， 建 议 选 中 Scale display to real 
size 选项 ， 这 样 可 以 将 模拟 器 设 为 一 个 较 小 的 尺寸 。 单 击 Launch 按钮 启动 模拟 器 。 


fos J 
| B Android Virtual Device Manager 


E 
List of existing Android Virtual Devices located at C Uzerz! Wei-Meng Leeandraorcawvd 
AWD Name Target Marne Platform APT Lewel 
se Android 4.0 Android 4.0 4.0 ARM (armeabi-vra] 
Android 4.0 Wita Google APIs (Google Inc.) 4,0 


ARM (armeabi-v7a) 


CPU/ABI 


fs) Launch Options 


Skim: WG 4800 (480800) 
Density; High (240) 
| Seale display to real size 


Screen Size (in); 8 
Monitor dpi: 
Scale 
[Wipe user data 
Launch from snapshot 


Save to snapshot 


«A valid Android Virtual Device. =) A reps 


*X An Ancroid Virtual Device that failed to]: 


图 1-21 


Android 模拟 器 将 会 启动 ， 等 待 一 会 后 就 可 以 使 用 了 ， 如 图 1-22 所 示 。 现 在 可 以 试 试 
模拟 器 的 用 法 , 它 就 像 实际 的 Android 设备 一 样 。 下 一 节 将 学 习 如 何 编写 你 的 第 一 个 Android 


8^ S3hAndroid 4.0 


Make yourself at home 


Y ou can put your favorite apps here. 


| 


jm seg py pn ura pon pn 


To See all your apps, touch the circle. 


Q7 Ta 
A “ts, 
p i 
ri * 
i 
wum | 
m mm | 
\, j 
4 Mar” f 
* rj 


图 1-22 


1.3 创建 第 一 个 Android 应 用 程序 
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在 所 有 的 工具 和 SDK 都 下 载 和 安装 好 以 后 ， 现 在 是 开动 马达 的 时 候 了 。 和 所 有 的 编 
程 书籍 一 样 , 第 一 个 示例 是 用 无 所 不 在 的 Hello World 应 用 程序 。 这 将 有 助 于 您 详细 了 解构 


成 一 个 Android 项 目的 不 同 组 件 。 
创建 第 一 个 Android 应 用 程序 


HelloWorld. zip FCX PEPI UE Wrox.com E PE 


(1) 启动 Eclipse, WEPESZ AA File | New | Project... 创 建 一 个 新 项 目 ( 如 图 1-23 所 示 )。 


E^ Java EE - Eclipse 


New 
Open File... 
Close 
Close All 
Save 

Save As... 
Save All 
Revert 

M OVE. të 
Rename.. 
Refresh 


Convert Line Delimiters To 
Print... 


Switch Workspace 
Restart 


Import... 
Export... 


Properties 


Exit 


Window Help 


Alt+Shift+N > | i55 JPA Project 


= Enterprise Application Project 
C$ Dynamic Web Project 
Şi EJB Project 


Ctrl+W 


Ctri- Shift- W 
* Connector Project 
Cars |g Application Client Project 

Qj Static Web Project 


Ctri« Shift-5 F* Project 


y Servlet 
$ Session Bean (EIB 3.x) 
: Message-Driven Bean (EJB 3.x) 
j Web Service 
“$ Folder 
* File 
1 Example... 


*. Other... 


y sheet and outline views 


Alt+ Enter 


ension points 


图 1-23 


Ctrl+N 
: "TU T 
Run SV 
integr 


注意 : 在 创建 了 您 的 第 一 个 Android 应 用 程序 后 ， 以 后 的 Android 项 目 可 以 通 
过 依次 选择 菜单 项 File | New | Android Project 来 创建 。 


(2) 展开 Android 文件 夹 ， 选 择 Android Project( 如 图 1-24 所 示 )， 单 击 Next 按钮 。 
(3) 按 图 1-25 所 示 将 Android 项 目 命名 为 HelloWorld， 然 后 单 击 Next 按钮 。 
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Java EE - Eclipse 


File Edit Refactor Eun Navigate Search — Project Window Help 
四 Welcome eo l l l 
e & am + 
Cverview Tutorial jp NUT MI 
TW Tw HW u rial | P ü 


人 Workbench 
= 


Samples 


| Select a wizard 


| type filber pest 
bodie e : | VE Java Project 
Eigen Sheen aoe oe 3E. Java Project from Existing Ant Buildfile 
iE Plug-in Project 
. ` > [> General 
Multi-page editor a 区 Android | 
Shows haw to create an ie Android Project | res available to custom text 
(Lo Android Sample Project 
TH Android Test Project 
Property sheet and ay | ^ = = 
Een SUE ree ud > B Eclipse Modeling Framework 
5 & EB i dalone SWT launcher or as an 
o [£5 lave 


pw ta plug into the Java 


Readme tool landalone applications 
Shows how to creabe you 


e platform and others will be 
workbench. 


图 1-24 
uS New Android Project 


Create Android Project 


Select project name and type of project 


Project Mame: HellaWorld 


(@) Create new project in workspace 
(^) Create project from existing source 
O Create project from existing sample 
[4] Use default location 

Location: | CY Users Wei-Meng Lee/Desktop/ Book Projects/Beginning And| | Browse... | 
Working sets 


Add project to working sets 


Working sets: | -| | Select... | 


图 1-25 


(4) 选择 Android 4.0 目标 ， 然 后 单 击 Next 按钮 。 
(5) 按照 图 1-26 PRIA S Application Info， 单 击 Finish 按钮 。 


者 的 巴 的 名 称 应 该 是 netleam2develop.HelloWorld. 
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uS New Android Project 


Application Info 
Configure the new Android Project 


Application Name: HelloWorld 
Package Name: net.learnzdevelon.HelleWorld 
| Create Activity; — HelloWorldActivity 


Minimum SDK: 14 


F] Create a Test Project 


[est Project Flame: | HelloWordT est 


Test Application: | HelloWorldTest 


Test Package: | net.learnzdevelop.HelleWorld.test 


图 1-26 


(6) JL, Eclipse IDE 应 该 如 图 1-27 所 示 。 
(7) 在 Package Explorer 窗口 (位 于 Eclipse IDE 的 左边 ) 中 ， 单 击 项 目 中 每 个 项 左 侧 显示 的 各 
种 箭头 ， 展 开 HelloWorld 项 目 ， 如 图 1-28 所 示 。 在 Tes/layout 文件 夹 中 ， 双 击 main xml 文件 。 


Java - Eclipse 
File Edit Refactor Run Navigate Search Project Window Help 


in-HgbinGiv5udgiw-O-Q-iug-imoe- H-E-oro- ry (Ss) +À Java t 
d Package Explorer Hu imp = A|| E] Task List TA = m ES Welcome T mL 
S d- Belə x ola 
a ay 
ts HelloWorld | Find q| P Al P Activate.. 


Overview 
Get an overview af the 
features 


© Connect Mylyn 器 


Connect to your task and ALM tools E 3 | Tutor ials 
or create a local task. = Go through tutorials 


^n outline is not available. 
Samples 


Iry outthe Samples 


What's How 
Find aut what IS new 


= f Workbench 
El Problems 5! 加 Javadoc | [&. Declaration a E E ELA 


0 items 


Descnption Resource 


图 1-27 
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EH Java - Eclipse 
File Edit Refactor Run Source Navigate Search Project Window Help 
[ou AG ud *-0O-G- H G- iu 4-7 Hrert dE 
J Package Enplan, — EL | e 7 7 = D|fBgl Tasktist BY = 11) (Welcome 13^ 
“ HelloWorld; 了 -| 国生 | el 6] a" 
a erc => 


a Hj netlesmidevelap.Hel loWorld fine | deem 


» n i Activit iay Chrardaw 
J j 山 oe Get an overview ofthe 
zs gen [Generated lava Files] i fealunas 
a 用 netlesm develop Hello World 


UE Q) Connect Mylyn 
J| R.jmen 


Android 4.D Connect to your task and ALM tools 


x = Be z 3 : or create a local task. 
> (es android,jar Wei-Meng Lee Desktop - | Tutorials 


Ha. assets © outline 32 m i Go through tutorials 
2 bin | 
ie res 
, REM rer 
à (=) drawable-hdpi 
[li ic Iauncherpng 
a [- drawable-ldpi 
[Bj ic launcher.png 


An outline is not available. 


Samples 
Try out the sarnniea 


a [EE drawsble-mdpi Tta 
Ii -unche png Find out what is new 
= layout "c ~ 25 
aA L— layou i mi Problems b X En Javadar la, Declaration | 
KE) rriain.«ml 2 
UE D items 
a > values dli P — OCT e 
i Workbench 
rid we — Ga to the workbench 
El AndroidManitest.xml 
图 prequard.chg 
E) project.properties 


图 1-28 


(8) main.xml 文件 定义 了 应 用 程序 的 用 户 界 面 (OD。 默 认 视 图 是 Layonut 视图 ， 以 图 形 化 的 
方式 显示 了 活动 。 要 修改 该 用 户 界 面 ， 可 单 击 位 于 底部 的 main.xml 选项 卡 ( 如 图 1-29 所 示 )。 


E Java - HelloWorkd/res/layocutmaian m] - Eclipse 
File Edit Refactor Run Navigate Search Project Window Help 
BG Ong BrO-~Q@r #@G@- BGE#- ; i t (S nva ] 9 Java EE 
E Fackage Explorer i tpo /3, mainaml 53 a= 


1 

k= Helle World 
$ S Editing config: defauk | Ary locale -| Android 4.0 
(B are —————— 


r 


B net learn2develop HelloWorld [2zin WVGA (Nexus t ~ [Parra -| Nerm ~|Daytir ~ | Theme -— — 


月 Helle World&ctrzity.java | 
pa ss - 加 图 | 回国 SARJAA 
EB. net.leam2develop.HelloWnorld > Form Widgets | 
jJ] R.jawa 
BA Android 4.0 
fe andraidjar - C:\\Wisers'\VWei-Mang 
Que assets 
ub bin 
gm m 
m 


listring/app name 


(e drawable-hdpi 

B c launcher png 
(e drawable-ldpi 

B sc launcher.pnag 


(=> drawabla-mdgi C3 Text Fi 
By sc launcher.pna - 


Ee Iaut - Layouts: 
X| main.xml L3 Canamsile 
(> values [B Images & Media 


K| strings.xml (3 Time & Date 
回 AndroeidManifestom! 


[3 Transitions rese -— 
proguard.cfy Couldn't resolve resource (string/app nare 


3 Advanced Couldn't resolve resource (strimg/hello 
LI Other 
L2 Custom & Lih 


[Ei Problems ®© Javadoc |i. Declaration | EJ Console $ in |) et E)- T3- ^ C 
Android 

[2811-18-38 85:19:39 - SDE Manager] Deleting file C:\Wsers\Wwel-Meng LeeX.androldWavdWAr = 
[2811-18-38 85:13:38 = SDE Manager] Deleting folder C:XUzerssWel-Meng Lee’. andradd\avd* 


[2811-18-38 mH5:13:3g - S00 Manaser] AVI ‘dadenid?.3' deleted. 
4 til | F 


"| praject.preperties 


图 1-29 


(9) 把 下 列 粗 体 显 示 的 代码 添加 到 main.xml 文件 中 : 


<?xml version="1.0" encoding-"utfí-8"?» 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/ 
android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation-"vertical" > 
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<TextView 


android:layout width="fill parent" 
android:layout height="wrap content" 


android:text-"8string/hello" /> 


<TextView 


android: layout width="fill parent" 
android: layout height="wrap content" 
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android:text="This is my first Android Application!" /> 


<Button 


android: layout width="fill parent" 
android:layout height="wrap content" 


android: text="And this is a clickable button!" /> 


</LinearLayout> 


(10) 按 Ctrlts 组 合 键 保 存 对 项 目的 修改 。 
(11) 现在 可 以 着 手 准 备 在 Android 模拟 器 上 测试 应 用 程序 了 。 在 Eclipse 中 右 击 项 目 名 


称 ， 并 选择 Run As | Android Application, WK 1-30 所 示 。 


z 
© Java - Eclipse 


File Edit Refactor Run Source Navigate Search Project Window Help 
mg gg 
E Package Explorer 53 = 


P 


i EN = 
a a Hellovorle 


(12) WMA PRA 
运行 ， 如 图 1-31 所 示 。 


Mew 
Go [nto 


Open in New Window 
Open Type Hierarchy 
Show In 


| =| Copy 
z Copy Qualified Name 
国 Paste 
. Delete 


Remove from Context 
Build Path 
Source 


Refactor 


i Import... 
| Export... 


^ Refresh 


Close Project 

Assign Working Sets... 
Run As 

Debug As 

Profile As 

Validate 

Team 


Compare With 


Restore from Local History... 


Android Tools 


Configure 


Properties 


hy OrQ~ 


F4 
Alt« Shift Wi k 


Ctrl-C 
Ctrl+V 
Delete 


Ctrl Alt+ Shift+Down 
k 
Alt+-Shift+S + 
Alt+Shit+T + 


Alé+ Enter 


图 1-30 


# @ 


F T uj ow m se 1 


Alt-Shift- X, A 


Alt+Shift+x, | 


Alte Shifter X, T i 
Run Configurations... i 


HR DUCE RDA A IMHE CR RIFLE Android 模拟 如 中 
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pe HelloWorld 


Hello World, HelloWorldActivity! 


This is my first Android Application! 


And this is a clickable button! AG Oh O © 


í ww v, 
OOOO 


o jw|E |n |r ly lui o |e 
a |s p fe le |u |) |k |t es 
@|z |x |c jv le In |n |. |e 


图 1-31 
(13) 单 击 Home 按钮 (位 于 键盘 上 左下 角 的 房子 图 标 )， 将 显示 主屏 内 容 ( 如 图 1-32 所 示 )。 


图 1-32 


(14) 单 击 应 用 程序 的 启动 器 图 标 来 显示 已 安装 到 设备 上 的 应 用 程序 列表 。 注 意 ， 
HelloWorld 现在 已 安装 在 应 用 程序 启动 器 中 (如 图 1-33 Aras). 
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IZ 


a 
d — 0 


O# $97 oeoo 


Clock Custom Loca Dev Tools Downloads 


Browser Calculator Calendar Camera 


Email Gallery HelloWorld | Messaging 


^, 
EXE! 


People Phone Search 


b à 


Settings Speech Reco 


将 用 哪 一 个 AVD 测试 您 的 应 用 程序 

回忆 一 下 先前 使 用 AVD Manager 创建 的 几 个 AVD. 那么 ， 当 运行 一 个 Android 应 用 程 
序 时 ，Eclipse 将 启动 哪 一 个 呢 ?Eclipse 会 检查 您 ( 当 创 建 一 个 新 项 目 时 ) 指 定 的 目标 ， 将 其 
与 已 经 创建 好 的 AVD 列表 对 照 ， 然 后 启动 第 一 个 匹配 的 AVD 来 运行 您 的 应 用 程序 。 

知 林 在 调试 应 用 程序 前 有 多 个 合适 的 AVD 正在 运行 ，Eclipse 将 显示 Android Device 
L1, 使 您 可 以 从 中 选择 想 要 使 用 的 模拟 器 或 设备 来 调试 应 用 程序 (如 图 1-34 所 示 )。 


fe] Android Device Chooser 


Chooser f£ 


Select a device co EEUU with me Android 4.0, 


Target Debug State 


wf Android 4.0 Yes Online 
Google APIs [.. Ves Online 


Serial Nurnber AVD Name 


国 emulatar-5558 Android 4.0 
a emiulator-5554 Android 4.0 WithMaps 


S Launch a new Android Virtual Device 
Platform API Level CPU/ABI 


AWD Name Target Name 


No AYD available 


Refresh 


MManager.. 


ae 


图 1-34 
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示例 说 明 
为 了 使 用 Eclipse 创建 一 个 Android 项 目 ， 需 要 提供 如 表 1-2 所 示 的 信息 。 
A 1-2 默认 方式 创建 的 项 目 文件 


m 性 ÓB 述 
Project name 项 目的 名 称 
Application name 用 户 友好 的 应 用 程序 名 称 
Package name 包 的 名 称 ， 必 须 使 用 反问 域名 
Create Activi 应 用 程序 中 第 一 个 活动 的 名 称 
Min SDK Version 项 目 所 需 的 最 低 版 本 的 SDK 


在 Android 中 ，Activity( 活 动 ) 是 一 个 包含 应 用 程序 的 用 户 界 面 的 窗口 。 


个 应 用 程序 


可 以 有 去 个 或 多 个 活动 。 本 例 中 ， 应 用 程序 包含 一 个 活动 : HelloWorldActivity。 这 个 
HelloWorldActivity 是 应 用 程序 的 入 口 点 , 在 应 用 程序 启动 时 显示 。 第 2 章 将 详细 讨论 活动 。 

在 这 个 简单 的 示例 中 ,修改 main xml 文件 以 显示 字符 串 “This is my first Android Application! " 
和 一 个 按钮 。main.xml 文件 包含 了 这 个 活动 的 用 户 界面 ， 此 界面 在 HelloWorldActivity 加 


载 时 显示 。 

当 在 Android 模拟 器 上 调试 应 用 程序 时 ， 应 用 程序 
会 自动 在 模拟 器 上 进行 安装 一 一 没 错 ， 您 已 经 开发 了 您 
的 第 一 个 Android 应 用 程序 ! 

下 一 节 将 揭示 您 的 Android 项 目 中 所 有 这 些 不 同 的 
文件 是 如 何 一 起 工作 来 使 应 用 程序 正常 运行 的 。 


1.4 Android 应 用 程序 剖析 


既然 已 经 创建 了 您 的 第 一 个 Hello World Android 应 
用 程序 ， 那 就 该 分 析 一 下 Android 项 目的 内 部 结构 ， 检 
查 一 下 使 之 工作 的 所 有 部 件 。 
首先 ， 请 注意 在 Eclipse 的 Package Explorer 中 所 显 
示 的 构成 Android 项 目的 不 同文 件 ( 如 图 1-35 所 示 )。 
这 些 不 同 的 文件 夹 及 其 文件 如 下 : 
e src 一 一 包含 项 目的 java 源 文件 。 在 本 例 中 ， 有 一 个 文 
件 : HelloWorldActivityjava. HelloWorld Activityjava 
文件 是 活动 的 源 文件 ， 您 将 在 这 个 文件 中 编写 应 用 程 
序 的 代码 。 这 个 Java 文件 在 项 目的 包 名 下 列 出 ， 在 本 
例 中 这 个 包 名 为 netlearn2develop.HelloWorld。 
包含 了 由 编译 器 生成 的 Rjava 文件 ， 它 


e gen 


File 


m Far 
ste 


al 
a 
a 


al 


al 


I. Java - Eclipse 
Edit Refactor 


COT 


Run Source Navigate Searct 
a Jud *9 
—— NER 

HelloWorld 
EŠ src 
4  net.learn2develop.HelloWorld 
» [J] HelloWorldActivityjava 
um gen [Generated Java Files] 
4 $6 net.learnzdevelop.HelloWorld 
» [f] Rjava 
mÀ Android 4.0 
p m android, jar - C:\Users\Wei-Meng Lee De 
aS assets 
E bin 
(= res 
>) classes.dex 
| HelloWorld.apk 
> resources.ap_ 
g> res 
4 (= drawable-hdpi 
Dy) ic launcher.png 
4 (= drawable-ldpi 
|B| ic launcher.png 
4 (= drawable-mdpi 
B, ic launcher.png 
4 (> layout 
|x) main.xml 
4 (= values 
[X| strings.xml 
al AndroidManifest.xml 
Ej proguard.cfg 
[3] project.properties 


HelloWorld/res/drawable- 


图 1-35 
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引用 在 项 目 中 能 找到 的 全 部 资源 。 不 要 修改 此 文件 。 项 目 中 的 所 有 资源 会 目 动 编译 
到 这 个 类 中 ， 所 以 可 以 使 用 这 个 类 引用 它们 。 
e Android 4.0 库 一 一 这 一 项 中 有 一 个 android jar 文件 ， 包 含 了 一 个 Android 应 用 程序 所 


需 的 所 有 类 库 。 
e assets 一 一 这 个 文件 夹 包 含 了 应 用 程序 所 用 到 的 所 有 资产 ， 例 如 HIML、 文 本 文件 、 
数据 库 等 。 


e bin 一 一 这 个 文件 夹 包 含 了 生成 过 程 中 ADT 生成 的 文件 。 特 别 是 ， 它 会 生成 .apk 文件 
(Android 包 )。.apk Android 应 用 程序 的 二 进 制 文件 ， 包 含 运行 Android 应 用 程序 所 
南 的 一 切 。 

这 个 文件 夹 包含 了 应 用 程序 中 使 用 的 所 有 资源 。 它 还 包含 了 几 个 子 文件 夹 : 
drawable-<resolution>、layout 和 values。 第 3 章 将 进一步 讨论 如 何 文 持 具有 不 同 屏 
磊 分 辨 率 和 像素 密度 的 设备 。 

e AndroidManifestxml 一 一 这 是 Android 应 用 程序 的 清单 文件 。 在 这 一 文件 中 ， 可 以 
指定 应 用 程序 所 再 的 权限 ， 还 可 以 指定 其 他 特性 (如 意图 关 选 侣 、 接 收 者 等 )。 第 2 
章 将 详细 讨论 AndroidManifest.xml 文件 的 使 用 。 

main.xml 文件 定义 了 活动 的 用 户 界 面 。 注 意 观 察 以 下 代码 的 粗 体 字 部 分 : 


<TextView 


e res 


android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="@string/hello" /> 
这 里 ，@string 指 的 是 位 于 res/values 文件 夹 下 的 strings.xml X fF. Flt, @string/hello 
指 的 是 在 strings.xml 文件 中 定义 的 hello TP, EN “Hello World, HelloWorldActivity! ": 


<?xml version-"1.0" encoding-"utfí-8"?» 


«resources» 


«string name="hello">Hello World, HelloWorldActivity!</string> 
«string name-"app name">HelloWorld</string> 


</resources> 


d DUE YF 8 a ee FA KS strings.xml 文件 中 ， 并 用 @string 
标识 符 引 用 这 些 字 符 串 。 这 样 ， 如 果 需 要 将 您 的 应 用 程序 本 地 化 为 另 一 种 语言 ， 则 只 需要 
备份 整个 values 文件 夹 ， 并 用 目标 语言 替换 strings.xml 文件 中 存储 的 字符 串 。 在 图 1-36 rm, 
使 用 了 另外 一 个 名 为 values-fr 的 文件 夹 ， 其 strings.xml 文件 中 包含 用 法 语 表 示 的 相同 的 
hello 字符 串 。 
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IH Java = HelloWorld/res/values-fr/strings.xml = Eclipse 

file Edit Run Source Navigate Search Project Refactor Window Help 

:r$- ll nag Gad $5-0-QqQ- EG- @64-: 
T- hE DA -E-i 


| [$ Package Explorer 15, ... 7 B | 1X) *stringsaml XV 
= | 7 = £?xml version="1.6" encodings “utf-8"?> 


= {Pesources> 


(ge drawable-ldpi 
t= drawable-mdpi 
ie layout 


?! strinas.xn a </resources> oft Related Tol | 
E 
x) strings.xml - í 
la Tp eee SL-XET " [E Index H 
=) proguard.cfg -Ea > Search exp 
[B project.properties a 
mm 


d 


t 区 Problems [e Javadoc B Declaration B Console Hw THX 


;m [] resources/string/#text Writable Smart Insert 


图 1-36 


如 果 用 户 在 一 台 被 配置 为 默认 显示 法 语 的 手机 上 加 载 这 个 应 用 程序 ， 应 用 程序 将 目 动 
显示 法 语 表 示 的 hello FAF. 

在 Android 项 目 中 ， 下 一 个 重要 的 文件 是 清单 文件 。 观 察 一 下 AndroidManifest.xml X: 
件 的 内 容 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.HelloWorld" 
android:versionCode-"]" 
android:versionName-"].0" > 


«uses-sdk android:minSdkVersion="14" /> 


«application 

android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

«activity 
android:label="@string/app name" 
android:name-".HelloWorldActivity" > 
«intenLt-Tilter > 

«action android:name-"android.intent.action.MAIN" /» 


«category android:name-"android.intent.category. 
LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 

文件 AndroidManifest.xml 包含 了 关于 应 用 程序 的 详细 信息 。 

e 它 定义 了 应 用 程序 的 包 名 : net.learn2develop.HelloWorld。 

e 应 用 程序 的 版 本 代码 为 1( 通 过 android:versionCode 属性 设置 )。 这 个 值 是 用 来 标识 
您 的 应 用 程序 的 版 本 号 。 它 可 用 于 以 编程 方式 确定 应 用 程序 是 否 需要 升级 。 
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e 应 用 程序 的 版 本 名 称 是 1.0( 通 过 android:versionName 属性 设置 )。 此 字符 串 值 主要 
用 来 显示 给 用 户 。 这 个 值 应 该 采用 以 下 格式 : <major>.<minor>.<point>.« 
e <Uses-sdk> 元 素 的 android:minSdkVersion 属性 指定 了 应 用 程序 运行 所 需 的 操作 系统 
的 最 低 版 本 。 
e 应 用 程序 使 用 位 于 drawable 文件 夹 下 的 图 像 ic_launcher.png。 
e 应 用 程序 的 名 称 是 在 strings.xml 文件 中 定义 的 名 为 app name 的 字符 串 。 
e HelloWorldActivity java 文件 代表 了 应 用 程序 中 的 一 项 活动 。 代 表 这 项 活动 的 标 
签名 称 与 应 用 程序 的 名 称 相 同 。 
e 在 这 项 活动 的 定义 中 ， 有 一 个 名 为 <intent-filter> 的 元 素 : 
© 意图 往 选 器 的 动作 名 称 为 android.intent.action.MAIN， 表 明了 这 项 活动 是 应 用 
程序 的 入 口 点 。 
© BA EASA APD android intent.category. LAUNCHER, 表明 了 应 用 程序 
可 从 设备 的 启动 器 图 标 启 动 。 第 2 章 将 详细 讨论 意图 。 
在 向 项 目 中 加 入 更 多 的 文件 和 文件 夹 后 ，Eclipse 将 自动 生成 及 java 的 内 容 ， 而 目前 包 
TUA PAR: 


/* AUTO-GENERATED FILE. DO NOT MODIFY. 


* This class was automatically generated by the 
* aapt tool from the resource data it found. It 
* should not be modified by hand. 

ud i 


package net.learn2develop.HelloWorld; 


public final class R | 
public static final class attr { 
} 
public static final class drawable { 
public static final int ic launcher-0x/f020000; 
) 
public static final class layout { 
public static final int main=0x/f030000; 
} 
public static final class string 1 
public static final int app name-0x/f040001; 
public static final int hello-0x/f040000; 


} 
建议 您 不 要 修改 Rjava 文件 的 内 容 。 当 您 修改 项 目 时 ，Eclipse 会 目 动 为 您 生成 相应 内 容 。 
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FE: wR AMAT Rjava LH, Eclipse 会 为 您 立即 再 重新 生成 一 个 。 注 
意 ， 为 了 使 Eclipse 可 以 生成 及 .java 文件， 您 的 项 目 不 能 包含 任何 错误 。 如 果 
在 删除 Rjava 后 发 觉 Eclipse 没有 重新 生成 这 个 文件 ， 那 么 您 需要 再 检查 一 遍 
JR EL. 代码 中 可 能 包含 语法 错误 或 者 XML 文件 (如 AndroidManifest.xml. main. 
xml 等 ) 的 格式 不 良好 。 


最 后 ， 把 活动 连接 到 用 户 界面 (main.xmD) 的 代码 是 位 于 HelloWorldActivityjava 文件 中 
的 setContentView0O 方 法 : 


package net.learn2develop.HelloWorld; 


import android.app.Activity; 
import android.os.Bundle; 


public class HelloWorldActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


) 


ix HB, R.ayout.main 指 的 是 位 于 res/layout 文件 夹 下 的 main. xml MF. E res/layout 
文件 夹 添 加 额外 的 XML 文件 时 ，R.java 中 将 目 动 生成 这 个 文件 名 。onCreate0 方 法 是 活动 
加 载 时 被 调用 的 多 个 方法 之 一 。 第 2 章 将 详细 讨论 活动 的 生命 周期 。 


15 ”本草 小 结 


本 章 介 绍 了 Android 的 概况 ， 并 强调 了 它 的 一 些 功能 。 如 果 您 已 经 按照 本 章 前 面 所 述 
下 载 了 工具 和 SDK, 那么 现在 应 该 有 了 一 个 工作 系统 -个 能 够 开发 其 他 比 Hello World 
更 有 趣 的 Android 应 用 程序 的 系统 。 在 第 2 章 ， 您 将 学 习 到 有 关 活 动 和 意图 的 概念 以 及 这 
些 概念 在 Android 中 所 扮演 的 重要 角色 。 
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1. 什么 是 AVD? 

2. AndroidManifest.xml 文件 中 的 android:versionCode 和 android:versionName 属性 有 什 
ZK Hil? 

3. strings.xml 文件 的 作用 是 什么 ? 

练习 答案 参见 附录 C. 


Android 操作 系统 


Android 应 用 程序 开发 语言 


Androld Market 
Android 应 用 程序 开发 工具 


活动 


Android 清单 文件 
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关键 概念 
Android 是 一 个 基于 Linux 的 开源 的 手机 操作 系统 。 它 可 以 供 任 
何 打算 使 之 在 其 自己 设备 上 运行 的 用 户 使 用 
使 用 Java 编程 语言 开发 Android 应 用 程序 。 编写 的 应 用 程序 被 编 
译 成 可 在 Dalvik 虚拟 机 之 上 运行 的 Dalvik 可 执行 文件 
Android Market 包括 了 由 第 三 方 开发 人 员 编写 的 各 种 Android 应 
用 程序 
Eclipse IDE, Android SDK 和 ADT 
Android 应 用 程序 中 的 一 个 屏幕 代表 一 个 活动 。 每 一 个 应 用 程序 
可 以 有 零 个 或 多 个 活动 
AndroidMainifestxml 文件 包含 了 应 用 程序 的 详细 配置 信息 。 随 大 
应 用 程序 变 得 更 加 复杂 ， 您 需要 不 断 修改 这 个 文件 ， 同 时 在 本 书 
的 学 习 过 程 中 ， 您 将 看 到 可 添加 到 这 个 文件 的 不 同 信息 
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本 章 将 介绍 以 下 内 容 : 

e 活动 的 生命 周期 

e 如 何 使 用 碎片 定制 UI 

e 如 何 对 活动 应 用 样式 和 主题 

e 如 何 将 活动 显示 为 对 话 框 窗口 

e 理解 意图 的 概念 

e 如 何 使 用 Intent 对 象 链接 活动 

e 意图 往 选 器 如 何 使 您 有 选择 地 链接 到 其 他 活动 
e 如 何 使 用 通知 问 用 户 显示 警报 


在 第 1 章 中 ， 您 已 经 知道 了 活动 就 是 一 个 包含 应 用 程序 的 用 户 界 和 面 的 窗口 。 一 个 应 用 
程序 可 以 包含 零 个 或 多 个 活动 。 通 常 ， 应 用 程序 具有 一 个 或 多 个 活动 ， 活 动 的 主要 目的 就 
是 与 用 户 交 互 。 一 个 活动 的 生命 周期 是 指 从 在 屏幕 上 显示 那 一 刻 起 一 直到 最 后 隐藏 所 经 历 
的 若干 个 阶段 。 理 解 活动 的 生命 周期 对 确保 应 用 程序 正确 地 工作 是 极其 关键 的 。 除了 活动 ， 
Android 4.0 还 支持 在 Android 3.0( 用 于 平板 电脑 ) 中 引入 的 一 种 功能 : 碎片 。 可 以 把 碎片 看 
做 “微缩 版 ”的 活动 ， 它 们 可 以 组 合 到 一 起 形成 活动 。 本 章 将 学 习 活 动 和 侠 片 是 如 何 协同 
工作 的 。 

Android 中 的 另 一 个 独特 的 概念 就 是 意图 。 一 个 意图 从 根本 上 来 说 就 是 能 够 将 来 自 不 
同 应 用 程序 的 不 同 活动 无 颖 连接 在 一 起 工作 的 “胶水 ”, 确保 这 些 任务 执行 起 来 像 是 都 属于 
-个 单一 的 应 用 程序 。 在 本 章 后 面 的 部 分 ， 您 将 学 习 到 有 关 这 一 重要 概念 的 更 多 内 容 ， 并 
学 会 如 何 使 用 它 来 调用 诸如 Browser. Phone. Maps SA EMH IEF o 


2.1 理解 活动 


首先 让 我 们 看 看 是 如 何 创建 一 个 活动 的 。 要 创建 一 个 活动 , 需要 创建 一 个 扩展 Activity 
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基 类 的 Java 25: 
package net.learn2develop.ActivitylOl; 


import android.app.Activity; 
import android.os.Bundle; 


public class ActivitylOlActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 

super.onCreate (savedinstanceState); 
setContentView(R.layout.main); 


) 


随后 ,您 自己 的 活动 类 将 使 用 在 res/layout 文件 夹 下 定义 的 XML 文件 加 载 此 活动 的 用 
户 界 面 (UD 组 件 。 本 例 中 ， 将 使 用 main.xml 文件 来 加 载 用 户 界面 : 


setContentView(R.layout.main); 


应 用 程序 中 的 每 一 个 活动 必须 在 AndroidManifest.xml 文件 中 声明 ， 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Activityl0l" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
<activity 
android: label="@string/app name" 
android: name=".Activity1l01lActivity" > 
<intent-filter > 
«action android: name="android.intent.action.MAIN" /> 


<category android: name="android.intent.category. 
LAUNCHER" /> 
</intent-filter> 
«/activity» 
</application> 


</manifest> 


Activity 基 类 定义 了 管理 一 个 活动 的 生命 周期 的 一 系列 事件 。 该 类 定义 了 如 下 事件 ; 
e onCreate() 一 一 当 活 动 首 次 被 创建 时 调用 。 


第 2 章 活动、 碎片 和 意图 


e ongStart0 一 一 当 活 动 对 用 户 可 见 时 调用 。 

e onResume() 当 活 动 与 用 户 开 始 交 互 时 调用 。 

e onPause() 一 一 在 当前 活动 被 暂停 并 恢复 以 前 的 活动 时 调用 。 

e onStop0 一 一 当 活 动 不 再 对 用 户 可 见 时 调用 。 

e onDestroy0 一 一 在 活动 被 系统 销毁 (手动 或 由 系统 执行 以 节省 内 存 ) 前 调用 。 

e onRestart() 一 一 在 活动 已 停止 并 要 再 次 启动 时 调用 。 

默认 情况 下 ， 所 创建 的 活动 包含 OnCreate0 事 件 。 在 这 个 事件 处 理 程序 中 含有 帮助 显 
示 屏 幕 的 用 户 界 面 元 素 的 代码 。 

图 2-1 展示 了 一 个 活动 的 生命 周期 及 其 所 经 历 的 各 个 阶段 一 一 从 活动 开始 直到 结束 。 

本 图 是 依据 Creative Commons 2.5 的 署名 许可 所 撒 述 的 条 和 坎 ， 复 制 了 Android 开源 项 目 创 
建 并 共享 的 工作 内 容 ， 详 见 http://developer.android.com/reference/android/app/Activity.html . 


活动 开始 ) 
用 户 导航 回 
onStart() : 


onRestart() 


这 个 活动 


回 到 前 台 


另 一 个 活动 出 现在 
这 个 酒 动 之 前 


这 个 活动 不 再 可 网 


”其 他 应 用 程序 


onStop() 


图 2-1 
要 了 解 一 个 活动 所 经 历 的 各 个 阶段 ， 最 好 的 办 法 是 创建 一 个 新 项 目 ， 实 现 各 种 事件 ， 
然后 使 活动 经 受 各 种 用 户 交 互 的 考验 。 
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理解 一 个 活动 的 生命 周期 


Activity101.zip FEAF X f£ uJ HUE Wrox.com E FE 


(1) 启动 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 命 名 为 ActivitylOl. 
(2) 在 Activity101Activityjava 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Activityl01l; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 


public class ActivitylOlActivity extends Activity I 
String tag = "Lifecycle"; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 
Log.d(tag, "In the onCreate() event"); 


public void onStart() 


i 
super.onStart(); 
Log.d(tag,"In the onStart() event"); 


public void onRestart() 
i 
super.onRestart(); 
Log.d(tag,"In the onRestart() event"); 


public void onResume () 
{ 
super .onResume () ; 
Log.d(tag,"In the onResume() event") ; 


public void onPause() 


{ 
super.onPause(); 
Log.d(tag,"In the onPause() event"); 


public void onStop() 
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super.onStop(); 
Log.d(tag,"In the onStop() event"); 


public void onDestroy() 
{ 
super.onDestroy(); 
Log.d(tag, "In the onDestroy() event"); 


(3) f£ F11 键 在 Android 模拟 右上 调试 应 用 程序 。 
(4) 当 活 动 第 一 次 被 加 载 时 ， 应 该 可 以 在 LogCat 窗口 中 看 到 与 下 而 类 似 的 内 容 ( 单 击 
Debug WK], 2 WK 2-2): 


11-16 06:25:59.396: D/Lifecycle(559): In the onCreate() event 
11-16 06:25:59.396: D/Lifecycle(559): In the onStart() event 
11-16 06:25:59.396: D/Lifecycle(559): In the onResume() event 


ie; DOMS - Activity101/src/netleamZdevelop/Activityl0L/ActivitylOlActivityjava - Eclipse 
File Edit Run Source  Mavigate Search Project Refactor Window Help 


图 Giyd:6*t-0-G-:ms4- Ei g&l Java $ Debug [f$ DOMS | 3 Java EE 
is EmiN-x-uorT-- 
yrs | | |  -—7m d Threads HM gi Heap Allocation Tracker tI File Explorer 
* | gg ui no client is selected 


Marne 
[3 emulator-5554 Dnline 
system process af 
com.android.systemur 141 
com android inputmethod.latin — 155 
71 —Ó eum 


(@ Emulator Control $i œ, 


Ce a a 


Saved Filters 十 一 Ed Search for messages. Accepts Java regexes. Prefix with pid: app: tag: or text: to limit scope. H X (10 | 
^ | 


All messages (no filters) 


Application Tag Text 
AndroidEuntime NOTE: attach of thread "Binder Thread $3' failed 
system process ActivityManager Start proc net.learn2develop.ActivitylUl for activ. 
sethecene lCountsS\et (10041, 1) failed with errno 一 全 
In the onCreate[] event 
In the on3rarr() EVENT 


net.learn2devel...  gralloc goldfish Emilator without SEU emulation detected. 

aystem process ActivityManager Displayed net.learnz2develop.Activitylül/.AÀcrtivityl! 
system process NetworkManagemen... setKernelCountSet(10004, 0) failed with errno 一 < 
android.process...  dalvikvm SC CONCUBREHT freed 312E, 5% Free I0356E/10823&, pl 3 | 
android.process...  MediaScenner Error opening directory "/mnt/sdcard/.androeid secu|* 


" F 


2-2 


(5) WR Android 模拟 器 上 按 Back 按钮 ， 可 以 观察 到 以 下 显示 内 容 : 


11-16 06:29:26.665: D/Lifecycle(559): In the onPause() event 
11-16 06:29:28.465: D/Lifecycle(559): In the onStop() event 
11-16 06:29:28.465: D/Lifecycle(559): In the onDestroy() event 
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(6) 按 住 Home 按钮 不 放 ， 同 时 单 击 Activities 图 标 可 以 看 到 以 下 内 容 : 

11-16 06:31:08.905: D/Lifecycle(559): In the onCreate() event 

11-16 06:31:08.905: D/Lifecycle(559): In the onStart() event 

11-16 06:31:08.925: D/Lifecycle(559): In the onResume() event 

(7) 4% F Android 模拟 器 上 的 Phone 按钮 ， 当 前 活动 就 会 被 推 到 后 台 ， 观 察 LogCat fi 
口中 的 输出 : 

11-16 06:32:00.585: D/Lifecycle(559): In the onPause() event 

11-16 06:32:05.015: D/Lifecycle(559): In the onStop() event 

(8) 注意 ，onDestroy0O 事 件 并 没有 被 调用 ， 表 明 这 个 活动 仍旧 在 内 存 中 。 按 Back 按钮 
退出 电话 拨号 程序 ， 活 动 又 再 次 显示 了 。 观 察 LogCat 窗口 中 的 输出 : 

11-16 06:32:50.515: D/Lifecycle(559): In the onRestart() event 


11-16 06:32:50.515: D/Lifecycle(559): In the onStart() event 
11-16 06:32:50.515: D/Lifecycle(559): In the onResume() event 


onRestartO 事 件 被 激活 ， 随 后 是 onStart0 和 onResume() FAF- 

示例 说 明 

从 这 个 简单 的 示例 可 以 看 出 ， 当 按 下 Back 按钮 时 ， 一 个 活动 就 被 销毁 了 。 知 道 这 一 
点 是 至 关 重 要 的 ， 因 为 无 论 活动 当 前 处 于 什么 状态 ， 它 都 将 丢失 。 因 此 ， 需 要 在 您 的 活动 
中 额外 写 一 些 代 码 以 便 在 活动 要 销毁 时 保存 其 状态 (第 3 章 将 告诉 您 怎么 做 )。 在 这 里 ， 注 
意 onPause0 事 件 在 两 个 情况 下 都 将 被 调用 一 一 当 活 动 被 送 入 后 台 以 及 用 户 按 了 Back 按钮 
而 终止 活动 时 。 

当 一 个 活动 开始 时 ，onStart0 和 onResume0 事 件 总 是 会 被 调用 ， 而 不 管 这 个 活动 是 从 
后 台 恢 复 的 还 是 新 创建 的 。 当 活动 第 一 次 创建 时 ， 会 调用 onCreate0 方 法 。 

从 这 个 示例 中 ， 可 以 获知 以 下 指导 原则 : 

e 使 用 onCreate(0 方 法 创建 和 实例 化 将 在 应 用 程序 中 使 用 的 对 象 。 

e 使 用 onResume0 方 法 局 动 当 活动 位 于 前 人 台 时 需要 运行 的 任何 服务 或 代 但 。 

e 使 用 onPause0 方 法 停止 当 活动 不 在 前 人 台 时 不 再 要 运行 的 任何 服务 或 代 但 。 

e 使 用 onDestroy0 方 法 在 活动 销毁 前 释放 资源 。 


注意 : 即使 一 个 应 用 程序 只 有 一 个 活动 并 且 这 个 活动 被 终止 了 , 该 应 用 程序 仍 
旧 会 运行 于 内 存 中 。 


2.1.1 如何 对 活动 应 用 样式 和 主题 


默认 情况 下 ， 一 个 活动 占据 整个 屏幕 。 然 而 ， 也 可 以 对 活动 应 用 一 个 对 话 框 主题 ， 使 
其 显示 为 一 个 浮动 对 话 框 。 例 如 ， 您 打算 定制 一 个 活动 ， 以 弹出 窗口 的 形式 显示 它 ， 用 来 


36 


第 2 章 活动、 碎片 和 意图 


提醒 用 户 将 执行 的 一 些 操 作 。 在 这 种 情况 下 ， 以 对 话 框 形式 显示 活动 以 引起 用 户 的 注意 是 
个 不 错 的 方法 。 

要 对 活动 应 用 对 话 框 主题 ， 只 要 修改 AndroidManifestxml 文件 中 的 <Activity> 元 素 ， 
添加 android:theme 属性 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.ActivitylOl" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" 
android: theme="@android: style/Theme.Dialog"> 
<activity 
android: label="@string/app name" 
android:name=".ActivitylOlActivity" > 
«intent-filter > 
<action android:name="android.intent.action.MAIN" /> 


«category android:name="android.intent.category. LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 

这 样 就 可 以 使 活动 显示 为 一 个 对 话 框 , 如 图 2-3 所 示 。 
2.1.2 ”隐藏 活动 标题 

如 果 需 要 的 话 ， 还 可 以 隐藏 一 个 活动 的 标题 (例如 当 
您 打算 向 用 户 显 示 状 态 更 新 时 )。 要 做 到 这 一 点 ， 可 以 使 


用 requestWindowFeature0 方 法 ， 传 递 Window.FEATURE - 
NO TITLE 和 常量 ， 如 下 所 示 : 


Fr 
i 555b Android d.ü 


Activity101 


import android.app.Activity; 
import android.os.Bundle; 


Hello World, Activity 101 Activity! 


import android.util.Log; 
import android.view.Window; 


public class ActivitylO0lActivity extends 
Activity { 
String tag = "Lifecycle"; 


图 2-3 
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/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) | 
super .onCreate (savedinstanceState) ; 
//---hides the title bar--- 
requestWindowFeature (Window. pnm 
FEATURE NO TITLE); 


setContentView(R.layout.main); 


Log.d(tag, "In the onCreate() 
event"); 


} 

这 样 ， 标 题 栏 就 被 隐藏 了 ， 如 图 2-4 所 示 。 
2.1.3 显示 对 话 框 窗 口 

您 经 常会 需要 显示 一 个 对 话 框 窗口 ， 以 便 从 用 户 那 
里 得 到 确认 。 这 时 ， 可 以 重 写 在 Activity 基 类 中 和 定义 的 


受 保护 的 onCreateDialog0 方 法 来 显示 一 个 对 话 框 窗口 。 
下 面 的 “ 试 一 试 ” 会 告诉 您 怎么 做 。 


图 2-4 


使 用 活动 显示 一 个 对 话 框 


Dialog.zip CHX PERI UE Wrox.com E FE 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 并 将 其 命名 为 Dialog。 
(2) 将 下 列 粗 体 显 示 的 语句 添加 到 main.xml 文件 中 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btn dialog" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Click to display a dialog" 
android: onClick="onClick" /> 


</LinearLayout> 


(3) 将 下 列 粗 体 显 示 的 语句 添加 到 Dialog Activity.java 文件 中 : 


package net.learn2develop.Dialog; 
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import android.app.Activity; 

import android.app.AlertDialog; 

import android.app.Dialog; 

import android.content.DialogInterface; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.Toast; 


public class DialogActivity extends Activity | 


活动 、 碎 片 和 意图 


CharSequence[] items = { "Google", "Apple", "Microsoft" }; 


boolean[] itemsChecked = new boolean [items.length]; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


public void onClick(View v) { 
showDialog (0); 


@Override 
protected Dialog onCreateDialog(int id) { 
switch (id) { 
case 0: 
return new AlertDialog.Builder (this) 
.setIcon(R.drawable.ic launcher) 


.setTitle("This is a dialog with some simple text...") 


.setPositiveButton("OK", 


new DialogInterface.OnClickListener() { 


public void onClick (DialogInterface dialog, int 


whichButton) 
{ 
Toast.makeText (getBaseContext(), 


"OK clicked!", Toast.LENGTH SHORT) .show() ; 


) 
. setNegativeButton ("Cancel", 
new DialogInterface.OnClickListener() { 


public void onClick (DialogInterface dialog, int 


whichButton) 
{ 
Toast .makeText (getBaseContext(), 


"Cancel clicked!", Toast.LENGTH SHORT) . 


show (); 
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} 
) 
.setMultiChoiceItems (items, itemsChecked, 
new DialogInterface.OnMultiChoiceClickListener() { 
public void onClick(DialogInterface dialog, 
int which, boolean isChecked) { 
Toast.makeText(getBaseContext(), 
items[which] + (isChecked ? " checked!":" 
unchecked!"), 
Toast.LENGTH SHORT).show(); 
) 


).create(); 


return null; rv This is a dialog with 
} some simple text 


Google 


) 


Apple 


(4) T£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 
单 击 按钮 显示 对 话 框 (如 图 2-5 所 示 )。 选 中 不 同 的 复 选 杠 
会 使 Toast 类 显示 那些 选中 /未 选中 项 的 文本 。 要 关闭 对 
话 杠 ， 可 单 击 OK 或 Cancel 按钮 。 


Microsoft 


Cancel 


Google checked! 


示例 说 明 
要 显示 一 个 对 话 框 ， 首 先 需要 实现 Activity 类 中 的 图 2-5 


onCreateDialog0 方 法 : 


@Override 

protected Dialog onCreateDialog(int id) { 
TETE 

} 


在 调用 showDialog0 方 法 时 调用 这 个 方法 : 


public void onClick(View v) { 
showDialog (0); 
} 


onCreateDialog0 是 一 个 用 于 创建 由 活动 管理 的 对 话 框 的 回调 方法 。 当 调用 showDialog() 
方法 时 ， 将 调用 这 个 回调 方法 。showDialog0 方 法 接受 一 个 整 型 参数 ， 用 来 标识 要 显示 的 
特定 对 话 框 。 本 例 中 使 用 了 一 个 switch 语句 来 标识 要 创建 的 不 同类 型 的 对 话 框 ， 不 过 这 时 
只 创建 了 一 种 类 型 的 对 话 框 。 后 和 面 的 “ 试 一 试 ” 将 扩展 这 个 示例 ,创建 不 同类 型 的 对 话 框 。 

要 创建 一 个 对 话 框 ， 需 要 使 用 AlertDialog 类 的 Builder 构造 国 数 来 设置 不 同 的 属性 ， 
例如 图 标 、 标 题 、 按 钮 以 及 复 选 框 : 
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@Override 
protected Dialog onCreateDialog(int id) { 
switch (id) { 
case 0: 
return new AlertDialog. Builder (this) 
.setIcon(R.drawable.ic launcher) 
.setTitle("This is a dialog with some simple text...") 
.setPositiveButton("OK", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int 
whichButton) 


Toast.makeText(getBaseContext(), 
"OK clicked!", Toast.LENGTH SHORT).show(); 


) 
.setNegativeButton("Cancel", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int 
whichButton) 
{ 
Toast.makeText (getBaseContext(), 
"Cancel clicked!", Toast.LENGTH SHORT) .show() ; 


) 
.setMultiChoiceItems (items, itemsChecked, 
new DialogInterface.OnMultiChoiceClickListener() { 
public void onClick(DialogInterface dialog, 
int which, boolean isChecked) { 
Toast.makeText(getBaseContext(), 
items[which] + (isChecked ? " checked!":" 
unchecked!"), 
Toast.LENGTH SHORT).show(); 


} 


).create(); 


} 


return null; 


} 


以 上 代码 使 用 setPositiveButton0 和 setNegativeButton0 方 法 分 别 设 置 了 两 个 按钮 : OK 
和 Cancel。 还 可 以 通过 setMultiChoiceItems0) 方 法 设置 一 个 复 选 框 列 表 供 用 户 选择 。 对 于 
setMultiChoiceItems0 方 法 ， 需 要 传 入 两 个 数组 : 一 个 是 要 显示 的 项 列表 ; 另 一 个 包含 了 表 
明 每 个 项 是 否 被 选中 的 值 。 当 选中 一 个 项 时 ， 使 用 Toast 类 来 显示 一 条 信息 ， 表 明 哪 一 项 

前 面 创建 对 话 框 的 代码 看 起 来 有 些 复杂 ,但 是 很 容易 把 它们 重 写 为 如 下 所 示 的 代码 : 
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package net.learn2develop.Dialog; 


import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.app.AlertDialog; 
android.app.AlertDialog.Builder; 
android.app.Dialog; 
android.content.DialogInterface; 
android.os.Bundle; 
android.view.View; 
android.widget.Toast; 


class DialogActivity extends Activity { 


CharSequence[] items = { "Google", "Apple", "Microsoft" }; 
boolean[] itemsChecked - new boolean [items.length]; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super. onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


public void onClick(View v) { 


showDialog (0); 


(|Override 


protected Dialog onCreateDialog(int id) { 


switch (id) { 
case 0: 
Builder builder - new AlertDialog.Builder(this); 
builder.setIcon(R.drawable.ic launcher); 
builder.setTitle("This is a dialog with some simple text..."); 
builder.setPositiveButton("OK", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int 
whichButton) { 
Toast.makeText(getBaseContext(), 
"OK clicked!", 
Toast.LENGTH SHORT).show(); 


); 


builder .setNegativeButton ("Cancel", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int 
whichButton) 1 
Toast.makeText(getBaseContext(), 
"Cancel clicked!", Toast.LENGTH SHORT). 
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show() : 


) ; 


builder.setMultiChoiceItems (items, itemsChecked, 
new DialogInterface.OnMultiChoiceClickListener() { 
public void onClick(DialogInterface dialog, 
int which, boolean isChecked) { 
Toast.makeText(getBaseContext(), 

items[which] + (isChecked ? " checked!": 
unchecked!"), 
Toast.LENGTH SHORT).show(); 


= 
= 


} 
} 
l; 
return builder.create(); 
} 
return null; 
} 
} 
上 下 文 对 象 


在 Android 中 常常 会 过 到 Context 类 和 其 实例 。Context 类 的 实例 常用 来 给 应 用 程序 提 
共 引 用 。 例 如 ， 在 本 示例 中 ，Toast 类 的 第 一 个 参数 接受 一 个 Context HR. 
.SetPositiveButton ("OK", 
new DialogInterface.OnClickListener() | 
public void onClick(DialogInterface dialog, int whichButton) 
{ 
Toast .makeText (getBaseContext(), 
"OK clicked!", Toast.LENGTH SHORT) .show(); 


} 
但 是 ， 由 于 Toast0 类 并 没有 在 活动 中 直接 使 用 (而 是 在 AlertDialog 类 中 使 用 )， 因 此 和 需 
要 使 用 getBaseContextO 方 法 返回 一 个 Context 类 的 实例 。 


男 一 个 会 过 到 Context 类 的 地 方 是 当 在 一 个 活动 中 动态 创建 视图 时 。 例 如 ， 您 可 能 想 
通过 代码 动态 创建 一 个 TextView 视图 。 因 此 ， 使 用 如 下 语句 实例 化 TextView 类 : 


TextView tv = new TextView(this); 


Text View 类 的 构造 函数 接受 一 个 Context MHA, FA Activity 类 是 Context 类 的 子 类 ， 
因此 可 以 使 用 this 关键 字 来 代表 这 个 Context WH. 


2.1.4 显示 进度 对 话 框 
Android 设备 的 另外 一 个 常见 的 用 户 界 面 功能 是 在 应 用 程序 执行 长 时 间 运 行 的 任务 时 
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显示 的 Please wait 对 话 框 。 例如 , 应 用 程序 可 能 需要 在 登录 到 服务 需 以 后 才能 让 用 户 使 用 ， 
或 者 需要 在 执行 计算 后 才能 显示 结果 给 用 户 。 在 这 类 情况 中 ， 显 示 “ 进 度 对 话 框 ”很 有 帮 
助 ， 这 样 用 户 可 以 知道 操作 正在 进行 中 。 

下 面 的 “ 试 一 试 ” 将 告诉 您 如 何 显 示 一 个 进度 对 话 框 。 


显示 一 个 进度 (Please Wait) 对 话 框 
(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 

xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-" vertical" > 


«Button 
android:id="@+id/btn dialog" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Click to display a dialog" 
android:onClick-"onClick" /» 


«Button 
android:id-"à*id/btn dialog2" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Click to display a progress dialog" 
android:onClick="onClick2" /> 


</LinearLayout> 


(2) 在 DialogActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop. Dialog; 


import android.app.Activity; 

import android.app.AlertDialog; 

import android.app.AlertDialog.Builder; 
import android.app.Dialog; 

import android.app.ProgressDialog; 
import android.content.DialogInterface; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.Toast; 


public class DialogActivity extends Activity { 
CharSequence[] items = { "Google", "Apple", "Microsoft" j; 
boolean[|] itemsChecked = new boolean [items.length]; 
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/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


public void onClick(View v) { 
showDialog (0); 


public void onClick2 (View v) { 
//---show the dialog--- 
final ProgressDialog dialog = ProgressDialog. show ( 
this, "Doing something", "Please wait...", true); 
new Thread (new Runnable () { 
public void run () { 
try { 
//---simulate doing something lengthy--- 
Thread.sleep (5000); 
//---dismiss the dialog--- 
dialog.dismiss(); 
} catch (InterruptedException e) { 
e.printStackTrace(); 


: 
) ECCE: 


}) .start(); 


} 
@Override 
protected Dialog onCreateDialog (int id) 
{ ... } 
} Doing something 


(3) 按 F11 键 在 Android 模拟 器 上 对 应 用 程序 进行 CO) Please wat. 
调试 。 单 击 第 二 个 按钮 会 显示 进度 对 话 框 ， 如 图 2-6 所 
示 。5 秒 钟 后 它 会 消失 。 

示例 说 明 

为 了 创建 一 个 进度 对 话 框 ， 首 先 要 创建 一 个 
ProgressDialog 类 的 实例 并 调用 其 show0 方 法 : 


//---show the dialog--- 
final ProgressDialog dialog = ProgressDialog.show( 


this, "Doing something", "Please walt...", true); 


图 2-6 


这 时 会 显示 刚才 看 到 的 进度 对 话 框 。 这 是 一 个 模 态 对 话 框 ， 所 以 会 阻塞 用 户 界 面 ， 直 
到 关闭 它 为 止 。 为 在 后 台 执 行 长 时 间 运 行 的 任务 , 使 用 了 一 个 Runnable 代码 块 创建 了 一 个 
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Thread 线程 (第 11 章 将 详细 介绍 线程 )。run0 方 法 中 的 代码 将 在 一 个 单独 的 线程 中 执行 ， 本 
例 中 在 mn0 方 法 中 使 用 sleepO0 方 法 插入 延迟 ， 模 拟 了 一 个 执行 5 秒 钟 的 操作 : 


new Thread(new Runnable(){ 
public void run() { 
try | 
//---simulate doing something lengthy--- 
Thread.sleep(5000); 
//---dismiss the dialog--- 
dialog.dismiss(); 
} catch (InterruptedException e) | 
e.printStackTrace(); 
} 
} 
}) -start () 7 


5 秒 钟 过 后 ， 调 用 dismiss() 方 法 关闭 进度 对 话 框 。 
2.1.5 显示 更 复杂 的 进度 对 话 框 


除了 前 一 节 创 建 的 一 般 性 的 please wait 对 话 框 以 外 , 还 可 以 创建 一 个 显示 操作 进度 (如 
下 载 状 态 ) 的 对 话 框 。 
下 面 的 “ 试 一 试 ” 示 范 了 如 何 显 示 一 个 有 特定 用 途 的 进度 对 话 框 。 


显示 操作 的 进度 
(1) 使 用 前 一 节 创建 的 同一 个 项 目 ， 在 main xml 文件 中 添加 下 面 的 粗 体 代码 : 


<?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<Button 
android:id="@+id/btn dialog" 
android: layout width="fill parent" 
android:layout height="wrap content" 
android:text-"Click to display a dialog" 
android:onClick-"onClick" /» 


«Button 
android:id="@+id/btn dialog2" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Click to display a progress dialog" 
android:onclick-"onclick?2" /> 


«Button 
android: id="@+id/btn_dialog3" 
android: layout width="fill parent" 
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android:layout height="wrap content" 
android: text="Click to display a detailed progress dialog" 
android:onClick="onClick3" /> 


</LinearLayout> 


(2) 在 DialogActivity java 文件 中 添加 下 面 的 粗 体 代码 : 


package net.learn2develop.Dialog; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.app.AlertDialog; 
android.app.AlertDialog.Builder; 
android.app.Dialog; 
android.app.ProgressDialog; 
android.content.DialogInterface; 
android.os.Bundle; 
android.view.View; 
android.widget.Toast; 


class DialogActivity extends Activity 1 


CharSequence[] items = { "Google", "Apple", "Microsoft" }; 
boolean[|] itemsChecked = new boolean [items.length]|; 


ProgressDialog progressDialog; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) | ... } 


public void onClick(View v) { ... } 


public void onClick2(View v) { ... ] 


public void onClick3(View v) { 


showDialog (1); 
progressDialog.setProgress (0); 


new Thread(new Runnable()í 
public void run() { 
for (int i-1; 1<=15; i++) { 
try { 
//---simulate doing something lengthy--- 
Thread.sleep(1000); 
//---update the dialog--- 


progressDialog.incrementProgressBy ((int) (100/15)); 


} catch (InterruptedException e) { 
e.printStackTrace(); 


} 
progressDialog.dismiss(); 
} 
)).start(); 


AT 
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@Override 
protected Dialog onCreateDialog(int id) { 
switch (id) { 
case 0: 
return new AlertDialog.Builder (this) 
FE es 


).create(); 


case 1: 

progressDialog - new ProgressDialog(this); 
progressDialog.setIcon(R.drawable.ic launcher); 
progressDialog.setTitle("Downloading files..."); 
progressDialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL); 
progressDialog.setButton(DialogInterface.BUTTON POSITIVE, "OK", 

new DialogInterface.OnClickListener() { 

public void onClick(DialogInterface dialog, 

int whichButton) 

i 

Toast.makeText(getBaseContext(), 
"OK clicked!", Toast.LENGTH SHORT).show(); 


Hz 
progressDialog.setButton(DialogInterface.BUTTON NEGATIVE, 
"Cancel", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText (getBaseContext(), 
"Cancel — | 
clicked!", Toast.LENGTH SHORT). ts 
show () ; 
) 
); 


return progressDialog; 


return null; 


p Downloading files... 


) 

(3) 按 F11 &tft Android 模拟 器 上 调试 应 用 程序 。 
单 击 第 三 个 按钮 显示 进度 对 话 框 ， 如 图 2-7 所 示 。 注 意 
进度 条 将 会 逐渐 增加 到 10096. 


示例 说 明 


为 创建 一 个 对 话 框 来 显示 操作 进度 ， 首 先 创 建 
ProgressDialog 类 的 一 个 实例 , 并 设置 其 各 个 属性 ， 如 图 图 2-7 


Cancel 
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标 、 标 题 和 样式 : 


progressDialog = new ProgressDialog(this); 
progressDialog.setlIcon(R.drawable.ic launcher); 
progressDialog.setTitle("Downloading files..."); 
progressDialog.setProgressStyle(ProgressDialog.STYLE 
HORIZONTAL) ; 


然后 设置 在 进度 对 话 框 中 显示 的 两 个 按钮 。 


progressDialog.setButton(DialogInterface.BUTTON POSITIVE, "OK", 
new DialogInterface. 
OnClickListener() I 
public void onClick 
(Dialoginterface dialog, 
int whichButton) 
{ 
Toast.makeText (getBaseContext (), 
"OK clicked! ", Toast.LENGTH SHORT) .show(); 


H); 
progressDialog.setButton (DialogInterface.BUTTON NEGATIVE, "Cancel", 
new Dialoginterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) 


Toast.makeText (getBaseContext (), 
"Cancel clicked!", Toast.LENGTH SHORT) .show(); 


Fs 


return progressDialog; 


P" Downloading files... 


前 面 的 代码 段 会 显示 一 个 进度 对 话 框 ， 如 图 2-8 所 示 。 
要 在 进度 对 话 框 中 显示 进度 状态 , 可 以 使 用 Thread 对 象 来 
运行 一 个 Runnable (RIH: 2.8 


Cancel 


progressDialog.setProgress(0); 


new Thread(new Runnable()í 
public void run(){ 
for (int i=l; i<=15; i++) [| 
try 1 
//---simulate doing something lengthy--- 
Thread.sleep(1000); 
//---update the dialog--- 
progressDialog.incrementProgressBy ( (int) (100/15)); 
} catch (InterruptedException e) { 

e .printStackTrace (); 
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progressDialog.dismiss(); 
} 
}) -start {}); 


这 段 代 人 码 中 让 进度 从 1 增加 到 15， 每 隔 一 秒 钟 增加 到 下 一 个 数字 。incrementProgressByYO 
方法 增加 进度 对 话 框 中 的 计数 。 当 进度 对 话 框 到 达 100% Ja, MAHE o 


22 使 用 意图 链接 活动 


个 Android 应 用 程序 可 以 包含 零 或 多 个 活动 。 当 应 用 程序 具有 多 个 活动 时 ， 您 可 能 
需要 从 一 个 活动 导航 到 另 一 个 活动 。 在 Android 中 ， 活 动 之 间 的 导航 通过 意图 来 完成 。 

要 理解 Android 中 这 个 非常 重要 又 有 些 抽象 的 概念 , 最 好 的 办 法 就 是 杀 上 自 去 体验 一 下 ， 
看 看 它 能 够 实现 什么 。 下 面 的 “ 试 一 试 ” 将 告诉 您 如 何在 一 个 已 有 的 项 目 中 添加 另 一 个 活 
动 ， 并 在 这 两 个 活动 之 间 实 现 导航 。 
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UsingIntent.zip fCf£Z X fF A] UTE Wrox.con E FE 


(1) 使 用 Eclipse 创建 一 个 新 的 Android 项 目 ， 命 名 为 UsingIntent. 
(2) A sre 文件 夹 下 的 包 名 ， 依 次 选择 New | Class 命令 (如 图 2-9 所 示 )。 


[me 
a [H8 src 
a| netJeam2develop.UsingIntent 


. Java Project 
Android Project 


tls assets Open in Mew Window ee- 
-| 
b te bi Open Type Hierarchy Package 
b dm res ; 
: Show [In Alte Shift+W k Class 
id AndreidManif 
Ej proguard.cfg | |= Copy Ctil« C Interface 


EL project.prope = Copy Qualified Name a 
ee Annotation 


Delete Source Folder 


Java Working Set 
Falder 

File 

Untitled Tert File 
Android XML File 
JUnit Test Case 
Task 


& Remove from Context Ctrl+Alt+ Shift+ Down 
Build Path + 
Source Alk+Shift+§ + 
Refactor Alt+Shift+T + 


jg Import... 
J Expert. 


riEgEmEL2[20 $9 GOCCE CEE 


References "7 Example... 


Declarations 


^ Other... 


Am Refresh 


图 2-9 


(3) 将 新 的 类 文件 命名 为 SecondActivity， 单 击 Finish 按钮 。 
(4) 将 下 列 粗 体 显 示 的 语句 添加 到 AndroidManifest.xml 文件 中 : 
<?xml version-"1.0" encoding-"utf-8"?» 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.UsingIntent" 
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android:versionCode="1" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
<activity 
android: label="@string/app name" 
android:name-".UsingIntentActivity" > 
«intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category. 
LAUNCHER" /» 
«/intent-filter» 
<factivity> 
<activity 
android: label="Second Activity" 
android:name=".SecondActivity" > 
<intent-filter > 
<action android: name="net.learn2develop.SecondActivity" /> 
<category android: name="android.intent.category.DEFAULT" /> 


</intent-filter> a (= Usinglrtent 
= a | al (B snc 
«/activity» 4 {H net.learn2develop.Usingintent 
< /appl i cat ion> » (J) SecondActivity java 


b [|J] UsinglrtentActivity.java 
[> pum gen [Generated Java Files] 
t HA Android 4.0 
</manifest> g 


GS assets 


» ES bin 


= 


EE res 


(5) 石 击 res/ layout 文件 夹 中 的 main.xml 文件 并 选择 Copy 命 b E drawable-hdpi 


D Ge drawable-Idpi 


令 创建 一 个 副本 。 然 后 右 击 res/layout 文件 夹 并 选择 Paste。 将 副 je su rr 


A [2 layout 


ie 


本 文件 命名 为 secondactivity.xml. Jüft, res/layout 文件 夹 下 就 包 ER 


b (2 values 


<7 J secondactivity.xml 文件 (如 图 2-10 所 7R) m : fn =a ao 
(6) 按 如 下 所 示人 修改 secondactivity.xml 文件 : IB project. properties 


2-10 


<?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"This is the Second Activity!" /> 


</LinearLayout> 


(7) 将 下 列 粗 体 显 示 的 语句 添加 到 SecondActivity.java 文件 中 : 
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package net.learn2develop.UsingIntent; 
import android.app.Activity; 
import android.os.Bundle; 


public class SecondActivity extends Activity{ 
QOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.secondactivity); 


} 


(8) 将 下 列 粗 体 显 示 的 语句 添加 到 main.xml 文件 中 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Display second activity" 
android: onClick="onClick"/> 


</LinearLayout> 


(9) 按 下 列 粗 体 字 内 容 修 改 UsingIntentActivity.java 文件 : 


package net.learn2develop.UsingIntent; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 


public class UsingIntentActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 

super .onCreate (SsavediInstanceState) ; 
setContentView (R.layout.main) ; 


public void onClick(View view) { 
startActivity (new Intent ("net.learn2develop.SecondActivity") ); 
} 


(10) 4% F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 当 第 一 个 活动 被 加 载 时 , 单 击 按钮 ， 
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第 二 个 活动 将 开始 加 载 ， 如 图 2-11 Pra. 


158a Ancrokd AD 


BB Usingintent 


Display second activity 


2-11 
示例 说 明 
正如 已 经 学 习 过 的 , 一 个 活动 是 由 一 个 用 户 界 面 组 件 ( 例 如 , main.xml) 和 一 个 类 组 件 ( 例 
如 ，UsingIntentActivityjava) 组 成 的 。 因 此 ， 如 果 想 回 项 目 中 添加 另外 的 活动 ， 需 要 创建 这 
两 个 组 件 。 
在 AndroidManifest.xml 文件 中 ， 专 门 添 加 了 以 下 内 容 : 
<activity 
android:label=" Second Activity" 
android:name=".SecondActivity" > 
<intent-ifilter > 
«action android:name-"net.learn2develop.SecondActivity" /> 
«category android:name-"android.intent.category.DEFAULT" /> 


</intent-filter> 
«/activity» 


到 这 里 ， 您 已 经 给 应 用 程序 添加 了 一 个 新 的 活动 。 注 意 以 下 事项 : 

e SUITE SIT) MS) SecondActivity. 

e 新 活动 显示 的 标签 名 称 为 Second Activity. 

e 新 活动 的 意图 策 选 器 的 名 称 是 net.learn2develop.SecondActivity。 其 他 活动 将 通过 这 
个 名 称 来 调用 这 个 活动 。 理 想 的 情况 下 ， 您 应 该 使 用 您 公司 的 反 回 域名 作为 意图 饥 
选 峰 的 名 称 ， 以 减少 同 另 一 个 应 用 程序 具有 相同 意图 科 选 器 名 称 的 可 能 性 (下 一 贡 
将 讨论 当 两 个 或 更 多 个 活动 具有 相同 的 意图 痪 选 器 时 会 发 生 什 么 )。 

e RIDEI] Æ android.intentcategory.DEFAULT。 您 需要 将 类 别 添 加 给 意图 
人 贤 选 器 ， 使 其 他 活动 可 以 通过 使 用 startActivity0 方 法 启动 这 个 活动 ( 稍 候 将 作 进 
步 介 绍 )。 
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单 击 按钮 时 ， 使 用 startActivity0 方 法 来 显示 SecondActivity， 可 以 通过 创建 一 个 Intent 
类 的 实例 并 将 SecondActivity HY xx Kl fie 2s 4 PK (EY net.learn2develop.SecondActivity) 传 递 给 
这 个 实例 来 完成 : 


public void onClick(View view) { 
startActivity (new Intent ("net.learn2develop.SecondActivity") ); 


} 


Android 中 的 活动 可 以 被 设备 上 运行 的 任意 应 用 程序 调用 。 例 如 ， 可 以 创建 一 个 新 的 
Android 项 目 , 然后 使 用 SecondActivity Bs ji as netlearn2develop.SecondActivity 来 显 
7x SecondActivity。 使 一 个 应 用 程序 容易 地 调用 其 他 应 用 程序 是 Android 中 的 基本 概念 之 一 。 

如 果 要 调用 的 活动 是 定义 在 同一 个 项 目 之 中 的 ， 可 以 像 下 面 这 样 重 写 先 前 的 语句 : 


startActivity(new Intent (this, SecondActivity.class) ); 
不 过 ， 只 有 当 要 显示 的 活动 与 当前 活动 在 同一 个 项 目 中 时 ， 这 种 方法 才 是 适用 的 。 
2.2.1 解决 意图 筛选 器 的 冲突 


在 前 一 节 中 , 我 们 知道 <intent-filter> 元 素 可 以 定义 一 个 活动 被 另 一 个 活动 调用 的 方法 。 
其 他 活动 (在 相同 或 一 个 单独 的 应 用 程序 中 ) 如 果 上 有 具有 相同 的 第 选 器 名 称 会 发 生 什么 呢 ?” 例 
wW, 假设 应 用 程序 有 另外 一 个 名 为 Activity3 的 活动 , 在 AndroidManifest.xml 文件 中 具有 以 
FAH: 

<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 

package-"net.learn2develop.UsingIntent" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
<activity 
android: label="@string/app name" 
android:name-".UsingIntentActivity" > 
«intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«activity 
android:label-"Second Activity" 
android:name-".SecondActivity" > 
«intent-i1lter > 
«action android:name-"net.learn2develop.SecondActivity" /» 
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«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 
«/activity» 


«activity 
android:label-"Third Activity" 
android:name-".ThirdActivity" > 
«intent-filter > 
<action android:name-"net.learn2develop.SecondActivity" /> 
«category android: name="android.intent.category.DEFAULT" /> 
</intent-filter> 
«/activity» 


</application> 
</manifest> 


WR AA RGN startActivityQ Hik, Android 操作 系统 会 显示 一 个 选择 ， 如 
图 2-12 所 示 : 


startActivity (new Intent ("net.learn2develop.SecondActivity")); 


如 果 您 选中 了 Use by default for this action 项 来 选择 一 个 活动 ， 那 么 下 一 回 将 再 一 次 调 
用 意图 net.learn2develop.SecondActivity， 它 将 总 是 启动 先前 您 选择 过 的 活动 。 

为 了 清除 这 个 默认 值 ， 转 到 Android 中 的 Settings 应 用 程序 ， 依 次 选择 Apps | Manage 
applications 命令 , 选择 应 用 程序 名 称 ( 如 图 2-13 所 示 )。 当 应 用 程序 的 详细 信息 显示 出 来 时 ， 
T£ BER JJ EEC HB IFA Clear defaults 按钮 。 


sd aui 40 


E^ s55dAndrod 40 DEPT 


mem App info | -- App info 


Usingintent 


version 1.0 


App 20.00KB 
USB storage app 0.00B 


Complete action using Force stop Uninstall Data 0.00B 


SD card 0.00B 
STORAGE 
Total 20.00KB 
App 20.00KB 
USB storage app 0.00B 
Data 0.00B 
SD card 0.006 


CACHE 


v^ Use by default for this action. Cache 
Clear default in Home Settings » 
Applications = Manage 
applications. 
LAUNCH BY DEFAULT 
You've chosen to launch this app by 
default for some actions 
CACHE 


. Clear defaults 
Cache 


2-12 2-13 
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2.2.2 MERRER 


startActivity0 方 法 调用 另 一 个 活动 ， 但 并 没有 返回 结果 给 当前 活动 。 例 如 ， 您 可 能 - 
-个 提示 用 户 输入 用 户 名 和 密码 的 活动 。 用 户 在 这 个 活动 中 输入 的 信息 需要 回 传 给 调用 它 
的 活动 来 作 进一步 的 处 理 。 如 果 需 要 从 一 个 活动 中 回 传 数据 ， 应 该 使 用 startActivity- 
ForResultO 方 法 。 下 面 的 “ 试 一 试 ” 演 示 了 这 一 过 程 。 
从 一 个 活动 获得 结果 
a) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 secondactivityxml 文件 中 添加 下 列 粗 体 显 示 的 


ili: 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"This is the Second Activity!" /» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Please enter your name" /» 


«EditText 
android: id="@+id/txt username" 
android: layout width-"fill parent" 
android: layout height="wrap content" /? 


«Button 
android: id="@+id/btn_ OK" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="0K" 
android: onClick="onClick"/> 


</LinearLayout> 
(2) 将 下 列 粗 体 显示 的 语句 添加 到 SecondActivityjava 文件 中 : 
package net. learn2develop.UsingIintent; 


import android.app.Activity; 
import android.content.Intent; 
import android.net.Uri; 

import android.os.Bundle; 
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import android.view.View; 
import android.widget.EditText; 


public class SecondActivity extends Activity{ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.secondactivity); 


public void onClick(View view) { 
Intent data = new Intent(); 


//---get the EditText view--- 
EditText txt username = 
(EditText) findViewById(R.id.txt username); 


//---set the data to pass back--- 
data.setData(Uri.parse( 

txt username.getText().toString())); 
setResult(RESULT OK, data); 


//---closes the activity--- 
finish(); 


) 
(3) 将 下 列 粗 体 显示 的 语句 添加 到 UsingIntentActivity java 文件 中 : 


package net.learn2develop.UsingIntent; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Toast; 


public class UsingIntentActivity extends Activity I 
int request Code = 1; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


public void onClick(View view) { 
//startActivity (new Intent ("net.learn2develop.SecondActivity")); 
/ /or 
//startActivity (new Intent (this, SecondActivity.class) ) ; 


T 
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startActivityForResult(new Intent ( 
"net.learn2develop.SecondActivity"), 
request Code); 


public void onActivityResult(int requestCode, int resultCode, Intent 
data) 
{ 
if (requestCode == request Code) { 
if (resultCode == RESULT OK) { 
Toast.makeText (this,data.getData().toString(), 
Toast.LENGTH SHORT) .show() ; 


} 


(4) f£ F11 键 在 Android 模拟 左上 调试 应 用 程序 。 当 加 载 第 一 个 活动 时 ， 单 击 按钮 ， 
SecondActivity 将 被 加 载 。 输 入 您 的 姓名 (如 图 2-14 所 示 ) 并 单 击 OK 按钮 。 这 时 ， 第 一 个 活 
动 会 显示 出 您 用 Toast 类 输入 的 名 字 。 


I 5AA dii B 55A A 


" Second Activity P Usinglntent 


This is the Second Activity! 


Display second activity 


lease enter your name 


. Wei-Meng Lee 


Wei-Meng Lee 


图 2-14 
示例 说 明 
调用 一 个 活动 并 等 等 从 此 活动 返回 结果 ， 需 要 使 用 startActivityForResultO 方 法 ， 如 下 
PTR: 


startActivityForResult (new Intent ( 
"net.learn2develop.SecondActivity"), 
request Code); 


除了 传 入 一 个 Intent 对 象 ， 还 需要 传 入 请 求 码 。 请 求 码 仅仅 是 一 个 整数 值 ， 用 来 标识 
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uiid 这 是 必须 的 ， 因 为 当 一 个 活动 返回 一 个 值 时 ， 必须 有 办 法 将 它 标识 出 来 。 
例如 ， 您 可 能 同时 在 调用 多 个 活动 ,而 一 些 活动 可 能 没有 立即 返回 (如 正在 等 竺 服务 器 的 应 
fo Dd NM EIF, EX Bock A OR AA FE SC bra Ind ES — 1 38529] e 


注意 : 如 果 请 求 码 设 为 -1， 则 使 用 startActivityForResultO 方 法 来 调用 活动 与 使 
— 用 startActivityO 方 法 来 调用 是 等 同 的 。 也 就 是 说 ， 没 有 结果 返回 。 


为 了 使 被 调 活动 可 以 返回 一 个 值 给 调用 它 的 活动 ， 可 以 通过 setData0 方 法 使 用 一 个 
Intent 对 象 来 回 传 数据 : 


Intent data = new Intent(); 


//---get the EditText view--- 
EditText txt username = 


(EditText) findViewById(R.id.txt username); 


//---set the data to pass back--- 
data.setData (Uri.parse( 


txt username.getText().toString())); 
setResult(RESULT OK, data); 


//---closes the activity--- 
finish(); 


setResult0 方 法 设置 了 一 个 结果 码 (RESULT OK 或 是 RESULT CANCELLED)7 和 回 传 
给 调用 活动 的 数据 (一 个 mtent 对 象 )。finishO 方 法 关闭 活动 并 将 控制 返回 给 调用 者 活动 。 

在 调用 者 活动 中 ， 需 要 实现 onActivityResult0 方 法 ， 一 个 活动 无 论 何 时 返回 都 要 调用 
这 个 方法 : 


public void onActivityResult(int requestCode 
Intent data) 


{ 


, int resultCode, 


if (requestCode == request Code) { 
if (resultCode == RESULT OK) { 
Toast.makeText (this ,data.getData().toString(), 
Toast.LENGTH SHORT) .show() ; 


) 


这 里 ， 检 验 请 求 和 结果 码 的 正确 性 ， 并 显示 返回 的 结果 。 返 回 的 结果 通过 data 参数 传 
和 入， 并且 通 过 getData0 方 法 来 获得 数据 的 细节 。 


2.2.3 使 用 意图 对 象 传递 数据 
除了 从 活动 返回 数据 外 ， 也 经 常 需要 传递 数据 给 活动 。 例 如 ， 在 前 面 的 示例 中 ， 您 可 


99 


60 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


能 想 在 活动 显示 之 前 在 EditText 视图 中 设 管 一 些 默 认 文本 。 对 此 ， 可 以 使 用 Intent 对 象 将 
这 些 数据 传递 给 目标 活动 。 

下 面 的 “ 试 一 试 ” 将 展示 在 活动 之 间 传 递 数 据 的 各 种 方法 : 
将 数据 传递 给 目标 活动 

(1) 使 用 Eclipse 创建 一 个 新 的 Android 项 目 ， 命 名 为 PassingData. 

(2) 将 下 列 粗 体 显示 的 代码 添加 到 main.xml 文件 中 : 


<?xml version-"1.0" encoding-"utfí-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btn SecondActivity" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="Click to go to Second Activity" 
android: onClick="onClick"/> 


</LinearLayout> 


(3) 在 res/layout 文件 夹 中 添加 一 个 新 的 XML 文件 ， 命 名 为 secondactivity.xml， 并 在 
文件 中 添加 下 面 的 代码 : 


<?xml version="1.0" encoding="utf£-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout width-"fill parent" 
android: layout height="fill parent" 
android: orientation="vertical" > 


<TextView 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Welcome to Second Activity" /> 


<Button 
android: id="@+id/btn MainActivity" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Click to return to main activity" 
android: onClick="onClick"/> 


</LinearLayout> 


(4) 在 包 中 添加 一 个 新 的 Clas 文件 ， 命 名 为 SecondActivity. E SecondActivity.java 
文件 中 添加 下 面 的 代码 : 
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package net.learn2develop.PassingData; 


import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.content.Intent; 
android.net.Uri; 
android.os.Bundle; 
android.view.View; 
android.widget.Toast; 


class SecondActivity extends Activity { 


@Override 
public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savediInstanceState) ; 
setContentView(R.layout.secondactivity); 


//---get the data passed in using getStringExtra()--- 
Toast.makeText (this,getiIntent().getStringExtra("stri"), 
Toast.LENGTH SHORT) .show() ; 


//---get the data passed in using getIntExtra()--- 

Toast.makeText(this,Integer.toString( 
getIntent().getIntExtra("agel", 0)), 
Toast.LENGTH SHORT).show(); 


//---get the Bundle object passed in--- 
Bundle bundle - getIntent().getExtras(); 


//---get the data using the getString()--- 
Toast.makeText(this, bundle.getString("str2"), 
Toast.LENGTH SHORT).show(); 


//---get the data using the getInt() method--- 
Toast.makeText(this,Integer.toString(bundle.getInt("age2")), 
Toast.LENGTH SHORT).show(); 


public void onClick(View view) { 


//---use an Intent object to return data--- 
Intent i = new Intent(); 


//---use the putExtra() method to return some 
// value--- 
i.putExtra("age3", 45); 


//---use the setData() method to return some value--- 
1.setData (Url. parse ( 


"Something passed back to main activity")); 


//---set the result with OK and the Intent object--- 
setResult(RESULT OK, i); 
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//---destroy the current activity--- 
finish (); 


) 


(5) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 代码 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.PassingData" 
android:versionCode-"]" 
android:versionName-"].0" > 


«uses-sdk android:minSdkVersion-"14" /> 


«application 
android:icon="@drawable/ic launcher" 
android:label-"8string/app name" > 
«activity 

android:label-"8string/app name" 
android:name-".PassingDataActivity" > 
<intent—Lilter > 
«action android: name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
«/intent-filter» 


«/activity» 

«activity 
android:label-"Second Activity" 
android:name=".SecondActivity" > 


<intent-filter > 
«action android:name-"net.learn2develop.PassingData 
SecondActivity" /» 
<category android:name-"android.intent.category.DEFAULT" /> 
</intent-filter> 
«/activity» 
«/application» 


</manifest> 


(6) 在 PassingDataActivity.java 文件 中 添加 下 列 粗 体 显示 的 代码 : 


package net.learn2develop.PassingData; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Toast; 
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public class PassingDataActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savediInstanceState) ; 


setContentView(R.layout.main); 


public void onClick(View view) { 


Intent i = new 
Intent("net.learn2develop.PassingDataSecondActivity"); 

//---use putExtra() to add new name/value pairs--- 

1.putExtra("stri", "This is a string"); 

i.putExtra("agel", 25); 


//---use a Bundle object to add new name/values 

// pairs--- 

Bundle extras - new Bundle(); 
extras.putString("str2", "This is another string"); 
extras.putInt("age2", 35); 


//---attach the Bundle object to the Intent object--- 
1.putExtras (extras); 


//---start the activity to get a result back--- 
startActivityForResult(i, 1); 


public void onActivityResult(int requestCode, 
int resultCode, Intent data) 


{ 


//---check if the request code is 1--- 
if (requestCode == 1) { 


//---if the result is OK--- 
if (resultCode == RESULT OK) { 


//---get the result using getIntExtra()--- 

Toast.makeText(this, Integer.toString( 
data.getIntExtra("age3", 0)), 
Toast.LENGTH SHORT).show(); 


//---get the result using getData()--- 
Toast.makeText(this, data.getData().toString(), 
Toast.LENGTH SHORT).show(); 
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(7) {È F11 E Android 模拟 器 上 调试 应 用 程序 。 单 击 每 个 活动 的 按钮 ， 观察 显示 的 值 。 
示例 说 明 
虽然 这 种 应 用 程序 并 不 华丽 ， 但 是 确实 可 以 演示 在 活动 之 间 传 递 数 据 的 一 些 重 要 的 方法 。 
首先 ， 可 以 使 用 Intent 对 象 的 putExtra0 方 法 添加 一 个 键 / 值 对 : 

//---use putExtra() to add new name/value pairs--- 


1.puLExtra(" stri", "This is a string"); 
i.putExtra("agel", 25); 


前 面 的 语句 回 Intent 对 象 添 加 了 两 个 键 / 值 对 : 一 个 是 String 类 型 的 ; 男 一 个 是 integer 
类 型 的 。 
除了 使 用 putExtra0 方 法 ， 还 可 以 创建 一 个 Bundle 对 象 ， 并 使 用 putExtras0 方 法 将 
Bundle 对 象 添 加 给 Intent 对 象 。 可 以 把 Bundle 对 象 看 做 一 个 包含 一 组 键 / 值 对 的 字典 对 象 。 
下 面 的 语句 创建 了 一 个 Bundle 对 象 ， 然 后 同 其 汶 加 了 两 个 键 / 值 对 。 然 后 把 Bundle 对 象 添 
加 给 Intent XJ $$ : 
//---use a Bundle object to add new name/values pairs--- 
Bundle extras = new Bundle(); 


exLtras.putString("str?", "This is another string"); 
extras.putint ("age2", 35); 


//---attach the Bundle object to the Intent object--- 
1.putExtras (extras); 


在 第 二 个 活动 中 , 为 了 获得 使 用 Intent 对 象 发 送 的 数据 ,首先 使 用 getIntent0 方 法 来 获 
取 该 Intent 对 象 ， 然 后 调用 该 对 象 的 getStringExtra0 方 法 来 获得 使 用 putExtra0 方 法 设置 的 
字符 串 值 : 

//---get the data passed in using getStringExtra()--- 


Toast.makeText(this,getIntent().getStringExtra("strl"), 
Toast.LENGTH SHORT).show(); 


本 例 中 ， 和 需要 根据 所 设置 数据 的 类 型 ， 调 用 合适 的 方法 来 提取 键 / 值 对 。 对 于 整数 值 ， 
使 用 getIntExtra0 方 法 (如 果 在 指定 的 名 称 中 没有 存储 值 ， 第 二 个 参数 会 使 用 默认 值 ): 


//---get the data passed in using getIntExtra()--- 
Toast.makeText(this,Integer.toString( 
getIntent().getIntExtra("agel", 0)), 
Toast.LENGTH SHORT).show(); 


为 了 获取 Bundle 对 象 ， 需 要 使 用 getExtras(0 方 法 : 


//---get the Bundle object passed in--- 
Bundle bundle = getIntent().getExtras(); 


为 了 获得 单独 的 键 / 值 对 ， 需 要 使 用 合适 的 方法 。 对 于 字符 串 值 ， 使 用 getString077 iX: 
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//---get the data using the getString() 一 一 一 
Toast.makeText (this, bundle.getString("str2"), 
Toast.LENGTH SHORT) .show(); 


类 似 地 ， 使 用 getInt0 方 法 可 以 获取 整数 值 : 


//---get the data using the getInt() method--- 
Toast.makeText(this,Integer.toString(bundle.getInt("age2")), 
Toast.LENGTH SHORT).show(); 


另外 一 种 给 活动 传递 数据 的 方法 是 使 用 setData0 方 法 (前 一 节 使 用 了 这 种 方法 )， 如 下 
所 示 : 


//---use the setData() method to return some value--- 
i.setData(Uri.parse( 
"Something passed back to main activity")); 


通常 ,使 用 setData0 方 法 来 设置 Intent 对 象 将 会 操作 的 数据 (例如 传递 一 个 URL 给 Intent 
对 象 ， 使 其 能 够 调用 Web Ù ARKEA: 更 多 示例 请 参看 本 章 后 徊 的 “使 用 意图 调用 
内 置 应 用 程序 ”一 节 )。 
为 获取 使 用 setData0 方 法 设置 的 数据 ， 需 要 使 用 getData0 方 法 (在 本 例 中 data 是 一 个 
Intent 对 象 ): 
//---get the result using getData()--- 


Toast.makeText(this, data.getData().toString(), 
Toast.LENGTH SHORT).show(); 


23 碎片 


前 一 节 学 习 了 什么 是 活动 和 如 何 使 用 活动 。 在 小 屏幕 设备 (例如 智能 手机 ) 上 ， 活 动 通 
弟 会 填 满 整个 屏幕 ， 显 示 构 成 应 用 程序 用 户 界 面 的 各 个 视图 。 活 动 本 质 上 是 视图 的 一 个 容 
器 。 但 是 ， 在 大 屏幕 设备 (例如 平板 电脑 ) 上 显示 活动 时 ， 就 有 些 不 太 合 适 了 。 因 为 屏幕 增 
大 了 ， 所 以 必须 排列 活动 中 的 所 有 视图 ， 以 便 充分 利用 增加 的 空间 ， 这 导致 需要 对 视图 层 
次 做 复杂 的 变动 。 更 好 的 方法 是 使 用 “ 微 活 动 ” 让 每 个 微 活动 包含 自己 的 一 组 视图 。 在 运 
行 时 , 根据 持 有 设备 的 屏幕 方向 ,一 个 活动 可 以 包含 一 个 或 者 多 个 这 样 的 微 活 动 。 在 Android 
3.0 及 更 高 版 本 中 ， 这 种 微 活动 被 称 为 “ 肆 片 ”。 

可 以 把 碎片 看 做 另外 一 种 形式 的 活动 。 就 像 活 动 一 样 ， 您 创建 信 片 来 包含 视图 。 俱 捷 
总 是 能 入 在 活动 中 。 例 如 ， 图 2-15 on SPARE. WEA 1 可 能 包含 一 个 ListView， 显 示 

-个 书 名 列表 。 碎 片 2 可 能 包含 某 些 TextView 和 ImageView， 显 示 一 些 文本 和 图 片 。 
现在 ， 假 设 应 用 程序 运行 在 Android 平板 电脑 (或 Android 智能 手机 ) 中 并 处 于 纵向 模式 。 
此 时 , WEA 1 可 能 能 入 在 一 个 活动 中 ， 而 侠 片 2 RATER MH, WA 2-16 所 示 。 当 
用 户 在 雁 片 1 的 列表 中 选择 一 项 时 ， 肆 片 2 将 会 启动 。 
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Fragment 1 Fragment 2 


Fragment 1 Fragment 2 


— 


Activity 1 Activity 2 


图 2-15 图 2-16 


如 果 应 用 程序 在 平板 电脑 中 改 为 以 横向 模 


式 显 示 ， 两 个 碎片 可 以 对 入 在 一 个 活动 中 ， 如 
图 2-17 所 示 。 

从 上 和 面 的 讨论 中 可 以 看 到 , ee A Android 
应 用 程序 用 户 界 和 面 的 创建 提供 了 一 种 灵活 的 方 
式 。 它 们 可 以 作为 用 户 界 面 的 基本 单元 ， 在 活 
动 中 动态 地 添加 或 移 除 ， 从 而 为 目标 设备 创建 


最 佳 的 用 户 体验 。 
Fi fg GAA” dO T EHI IAEA HIE. 


Fragment 1 Fragment 2 


Activity 1 
图 2-17 


Rh 
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(1) 使 用 Eclipse 创建 一 个 新 的 Android 项 目 ， 命 名 为 Fragments. 
(2) 在 res/layout 文件 夹 中 ,创建 一 个 新 文件 ， 命 名 为 fragmentl.xml， 并 在 该 文件 中 添 
加 下 面 的 代码 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android: background="#00FF00" 
> 
<TextView 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android:text="This is fragment #1" 
android: textColor="#000000" 
android: textSize="25sp" /> 
</LinearLayout> 
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(3) 仍然 在 res/layout 文件 夹 中 ,创建 男 外 一 个 新 文件 ， 命 名 为 fragment2.xml， 并 在 该 


文件 中 添加 下 和 面 的 代码 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android: background="#FFFE00" 
> 
<TextView 
android: layout width="fill parent" 
android:layout height="wrap content" 
android:text="This is fragment #2" 
android: textColor="#000000" 
android: textSize="25sp" /> 
</LinearLayout> 


(4) 在 main.xml 中 添加 下 面 的 粗 体 代码 : 


<?xml version-"1.0" encoding-"utí-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" > 


«fragment 


android:name-"net.learn2develop.Fragments.Fragmentl" 


android: id="@+id/fragment1" 

android: layout weight="1" 

android: layout width="0px" 

android: layout height="match parent" /> 
<fragment 


android:name="net.learn2develop.Fragments. 


android: id="@+id/fragment2" 

android: layout weight="1" 
android: layout width="0px" 

android: layout height="match parent" /> 


</LinearLayout> 


(5) ft net.learn2develop Fragments 包 名 下 , WIAA Java 类 文 
件 ， 分 别 命名 为 Fragment] java 和 Fraement2.java， 如 图 2-18 所 示 。 
(6) 在 Fragmentl.java 类 文件 中 添加 下 面 的 代码 : 


package net.learn2develop.Fragments; 


import android.app.Fragment; 
import android.os.Bundle; 


Fragment2" 


| 
p. 
4 i> Fragments 


4 (99 src 
4 LH netlearn2develop.Fragments 
J| Fragmentl java 
. |J] Fragment2 java 
J] FragmentsActivity.java 
b cn gen [Generated Java Files] 
ES Android 4.0 
z^ assets 
» ie» bin 


E» res 


图 2-18 
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import android.view.LayoutInflater; 
import android.view.View; 
import android.view.ViewGroup; 


public class Fragmentl extends Fragment { 
@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
//---Inflate the layout for this fragment--- 
return inflater.inflate( 
R.layout.fragmentl1, container, false); 


} 
(7) 在 Fragment2 java 类 文件 中 添加 下 面 的 代码 : 


package net.learn2develop.Fragments; 


import android.app.Fragment; 

import android.os.Bundle; 

import android.view.LayoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 


public class Fragment? extends Fragment { 
@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
//---Inflate the layout for this fragment--- 
return inflater.inflate( 
R.layout.fragment2, container, false); 


} 
(8) 按 F11 BETE Android 模拟 器 上 调试 应 用 程序 。 图 2-19 显示 了 活动 中 包含 的 两 个 碎片 。 


This is fragment #1 This is fragment #2 


图 2-19 
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示例 说 明 

健 片 的 行为 与 活动 十 分 相似 : 它 有 一 个 Java 类 ， 并 从 一 个 XML 文件 加 载 Ul. ix^ 
XML 文件 中 包含 了 在 活动 中 常见 的 UL 元 素 : TextView, EditText, Button 55. fr AY Java 
类 需要 继承 Fragment 基 类 : 


public class Fragmentl extends Fragment { 
} 


^ 注意: 除了 Fragment 基 类 ， 碎 片 还 可 以 继承 Fragment 类 的 几 个 子 类 ， 例 如 
Dialogfragment、ListFragment 和 PreferenceFragment。 第 4 章 将 详细 讨论 这 些 


为 了 绘制 雁 户 的 UL E5 y onCreateView0 方 法 。 访 方法 需要 返回 一 个 View TR, 
如 下 所 示 : 


public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
//-—--Inflate the layout for this fragment--- 
return inflater.inflate( 
R.layout.fragmentl, container, false); 
] 
这 里 使 用 一 个 LayoutInflater 对 象 来 增 大 指定 XML 文件 (本 例 中 为 R.layout.fragmentl) 
中 的 UL. container 参数 引用 父 ViewGroup, EER H] Sik AEA Aya). savedInstanceState 
参数 允许 将 碎片 还 原 到 前 一 次 保存 的 状态 。 
AN In] d HAS. EHI JS «fragment^76 Z : 


<?xml version-"1.0" encoding-"utfí-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" > 


«fragment 
android:name-"net.learn2develop.Fragments.Fragmentl" 
android:id="@+tid/fragment1" 
android:layout weight="1" 
android:layout width-"Opx" 
android:layout height="match parent" /> 

«fragment 
android:name-"net.learn2develop.Fragments.Fragment2" 
android: id="@+tid/fragment2" 
android: layout weight="1" 
android: layout width="0px" 
android: layout height="match parent" /> 
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</LinearLayout> 
VE BE A er 2 SE as WF, CY DAE android:id 或 android:tag 属性 进行 
WB. 


2.3.1 ES HF 


将 UI 分 割 为 多 个 可 配置 的 部 分 是 碎片 的 优势 之 一 ， 但 是 其 真正 的 强大 之 处 在 于 可 在 
运行 时 动态 地 把 它们 添加 到 活动 。 前 一 节 看 到 了 在 设计 时 通过 修改 XML 文件 可 以 同 活 动 
浴 加 碎片 。 在 实际 应 用 中 ， 如 果 能 够 创建 碎片 并 在 运行 时 把 它们 洪 加 a 到 活动 会 更 加 有 用 。 
这 样 就 可 以 为 应 用 程序 创建 可 以 上 自 定 义 的 用 户 界 面 。 例 如 ， 如 果 应 用 程序 运行 在 智能 手机 
上 ， 可 能 会 在 一 个 活动 中 填充 一 个 俯 片 : 如 果 应 用 程序 运行 中 平板 电脑 上 ， 可 能 在 一 个 活 
动 中 填充 两 个 或 更 多 个 碎片 ， 因 为 平板 电脑 的 屏幕 空间 比 智能 手机 大 得 多 。 

下 面 的 “ 试 一 试 ”演示 了 如 何以 编程 方式 在 运行 时 问 活 动 添加 俯 片 。 

在 运行 时 添加 碎片 
(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 main xml 文件 中 注释 掉 两 个 <fragmen 们 元 素 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" > 


<!-- 

<fragment 
android: name="net.learn2develop.Fragments.Fragmenti" 
android: id="@+id/fragment1" 
android: layout weight="1" 
android: layout width="0px" 
android: layout height="match parent" /> 

<fragment 
android:name="net.learn2develop.Fragments.Fragment2" 
android: id="@+id/fragment2" 
android: layout weight="1" 
android: layout width="0px" 
android: layout height="match parent" /> 

--> 

</LinearLayout> 


(2) 在 FragmentsActivity java 文件 中 添加 下 面 的 粗 体 代 码 : 
package net.learn2develop.Fragments; 


import android.app.Activity; 

import android.app.FragmentManager; 
import android.app.FragmentTransaction; 
import android.os.Bundle; 


TO 
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import android.view.Display; 
import android.view.WindowManager ; 


public class FragmentsActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 


FragmentManager fragmentManager = getFragmentManager () ; 
FragmentTransaction fragmentTransaction = 
fragmentManager.beginTransaction(); 


//---get the current display info--- 
WindowManager wm = getWindowManager () ; 
Display d = wm.getDefaultDisplay(); 

if (d.getWidth() » d.getHeight()) 


{ 
//---landscape mode--- 
Fragmentl fragmentl = new Fragmentl(); 
// android.R.id.content refers to the content 
// view of the activity 
fragmentTransaction.replace ( 
android.R.id.content, fragmentl); 
} 
else 
{ 
//---portrait mode--- 
Fragment2 fragment2 = new Fragment2(); 
fragmentTransaction.replace( 
android.R.id.content, fragment2); 
} 


fragmentTransaction.commit(); 

} 

(3) FÈ F11 键 在 Android Bil zs E3e 1T AREA. TERRE 2 45:40, AA 3-2 IR] BU, 
会 显示 人 碎片 2( 黄 色 )， 如 图 2-20 所 示 。 如 果 按 Ctrl+F11 ZAG BERR a8 HJ 73 186] OCA Ps In] , 
则 会 显示 碎片 1( 绿 色 )， 如 图 2-21 所 示 。 

示例 说 明 

AEEA RE, EH T FragmentManager 类 。 首 先 获得 该 类 的 一 个 实例 : 

FragmentManager fragmentManager = getFragmentManager(); 

还 需要 在 活动 中 使 用 FragmentTransaction 类 来 执行 碎片 操作 (例如 添加 、 删 除 或 奉 换 ): 


FragmentTransaction fragmentTransaction = 
fragmentManager.beginTransaction(); 
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menm ng mergi 下 pm my (CS oh H0 Ah 


图 2-20 图 2-21 
在 本 例 中 , 使 用 WindowManager 来 确定 设备 当前 处 于 纵 回 模式 还 是 横 回 模式 。 一 旦 确 
定 以 后 ， 问 活动 添加 合适 的 健 片 。 方 法 是 创建 伴 片 ， 然 后 调用 FragmentTransaction 对 象 的 
replace0 方 法 将 俯 片 添加 到 指定 的 视图 容 堪 (在 本 例 中 , android.R.id.content 引用 活动 的 内 容 
视图 ): 


//---landscape mode--- 

Fragmentl fragmentl = new Fragmentl(í(); 

// android.R.id.content refers to the content 

// view of the activity 

fragmentTransaction.replace( 
android.R.id.content, fragmentl); 


使 用 replace0) 方 法 本 质 上 相当 于 调用 FragmentTransaction 对 象 的 remove0 方 法 ， 然 后 
调用 其 add0 方 法 。 为 了 确 体 更 改 生效 ， 震 要 调用 commitO 方 法 : 


fragmentTransaction.commit (); 
2.3.2 ”碎片 的 生命 周期 


与 活动 类 似 ， 俱 片 具 有 上 自己 的 生命 周期 。 理 解 了 碎片 的 生命 周期 后 ， 您 可 以 在 税 片 被 
销毁 时 正确 地 保存 其 实例 ， 在 碎片 被 重新 创建 时 将 其 还 人 原 到 前 一 个 状态 。 
下 和 耐 的 “ 试 一 试 ” 展 示 了 健 片 的 各 个 状态 。 


理解 碎片 的 生命 周期 
_Fragments.zip XHHT UE Wroxcom EFE 
(1) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 Fragmenti java XEF YS P rf AAR: 


package net.learn2develop.Fragments; 
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import android.app.Activity; 

import android.app.Fragment; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.LayoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 


public class Fragment] extends Fragment { 
@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 


Log.d("Fragment 1", "onCreateView"); 


//---1nflate the layout for this fragment--- 
return inflater.inflate( 
R.layout.fragmentl, container, false); 


@Override 

public void onAttach(Activity activity) { 
super. onAttach (activity); 
Log.d("Fragment 1", "onAttach") ; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
Log.d("Fragment 1", "onCreate"); 


@Override 

public void onActivityCreated (Bundle savedInstanceState) { 
super. onActivityCreated (savedinstanceState) ; 
Log.d("Fragment 1", "onActivityCreated") ; 


@Override 

public void onStart() { 
super.onStart(); 
Log.d("Fragment 1", "onStart"); 


@Override 

public void onResume() { 
super .onResume () ; 
Log.d("Fragment 1", "onResume") ; 
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@Override 

public void onPause() { 
super.onPause(); 
Log.d("Fragment 1", "onPause"); 


@Override 

public void onStop() { 
super.onStop(); 
Log.d("Fragment 1", "onStop"); 


@Override 

public void onDestroyView() { 
super .onDestroyView () ; 
Log.d("Fragment 1", "onDestroyView"); 


@Override 

public void onDestroy() { 
super.onDestroy () ; 
Log.d("Fragment 1", "onDestroy"); 


@Override 

public void onDetach() { 
super.onDetach (); 
Log.d("Fragment 1", "onDetach"); 


} 

(2) 按 Ctrl+F11 组 合 键 将 Android 模拟 器 切换 到 横向 模式 。 

(3) 在 Eclipse 中 按 F11 键 ， 在 Android 模拟 器 上 调试 应 用 程序 。 

(4) 当 应 用 程序 加 载 到 模拟 器 中 后 ，LogCat 窗口 (Windows | Show View | LogCat) 会 显示 
以 下 内 容 : 

12-09 04:17:43.436: D/Fragment 1(2995): onAttach 

12-09 04:17:43.466: D/Fragment 1(2995): onCreate 

12-09 04:17:43.476: D/Fragment 1(2995): onCreateView 

12-09 04:17:43.506: D/Fragment 1(2995): onActivityCreated 


12-09 04:17:43.506: D/Fragment 1(2995): onStart 
12-09 04:17:43.537: D/Fragment 1(2995): onResume 


(5) 单 击 模拟 器 上 的 Hombe 按钮 。LogCat 窗口 中 会 显示 以 下 输出 : 


12-09 04:18:47.696: D/Fragment 1(2995): onPause 
12-09 04:18:50.346: D/Fragment 1(2995): onStop 


(6) 在 模拟 器 上 ， 单 击 并 按 住 Home 按钮 。 再 次 启动 应 用 程序 。 这 一 次 会 显示 以 下 输出 : 
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12-09 04:20:08.726: D/Fragment 1(2995): onStart 
12-09 04:20:08.766: D/Fragment 1(2995): onResume 


(7) 最 后 ， 单 击 模拟 器 上 的 Back 按钮 。 现 在 可 以 看 到 下 面 的 输出 ; 


12-09 04:21:01.426: D/Fragment 1(2995): onPause 

12-09 04:21:02.346: D/Fragment 1(2995): onStop 

12-09 04:21:02.346: D/Fragment 1(2995): onDestroyView 
12-09 04:21:02.346: D/Fragment 1(2995): onDestroy 
12-09 04:21:02.346: D/Fragment 1(2995): onDetach 


示例 说 明 
和 活动 一 样 ，Android 中 的 在 片 也 有 目 己 的 生命 周期 。 如 您 所 匈 ， 当 雄 片 被 创建 时 ， 


会 经 历 以 下 状态 : 


e onAttach() 

e onCreate() 

e onCreateView() 

e onActivityCreated() 

RFS LIN, BAA PAN: 

e onStart() 

e onResume() 

HEREA ERRAN, SAA PS: 

e onPause() 

e onStop() 

MAE Fr BUR SCC SBT EBON, aA PAS: 
e onPause() 

e onStop() 

e onDestroyView() 

e onDestroy() 

e onDetach() 

与 活动 一 样 ， 可 以 使 用 Bundle 对 象 在 以 下 状态 中 还 原 碎 片 的 实例 : 
e onCreate() 

e onCreateView() 

e onActivityCreated() 


注意 : 可 以 在 onSaveInstanceState(0) 方 法 中 保存 碎片 的 状态 。 第 3 章 将 详细 介 


绍 这 一 主题 。 


雄 片 经 历 的 状态 大 多 数 与 活动 类 似 。 但 是 ， 有 一 些 新 状态 是 肆 片 独 有 的 : 
e onAttached( 一 一 当 肆 片 与 活动 建立 关联 时 调用 。 


T5 
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e onCreateView0 一 一 用 于 创建 碎片 的 视图 。 
e onActivityCreated0 一 一 当 活 动 的 onCreate0 方 法 被 返回 时 调用 。 
e onDestroyView() —— HRE Fr Ir] pi EHE BRIN 8] H o 
e onDetach() —— HRE SiR IK RE RIN VA H] « 
注意 ,活动 和 碎片 之 间 存 在 一 个 主要 的 区 别 : 当 活 动 进入 后 台 时 ， 会 被 放 到 back stack 
中 。 这 样 当 用 户 按 Back 按钮 时 ， 活 动 可 以 恢复 。 但 是 ， 雄 片 在 进入 后 台 时 不 会 被 日 动 放 
到 back stack 中 。 要 实现 这 一 目的 ， 需 要 在 雁 户 处 理 期 间 显 式 调 用 addToBackStack() 777d, 
如 下 所 示 : 
//—-—-get the current display into--- 
WindowManager wm = getWindowManager(); 


Display d = wm.getDefaultDisplay(); 
if (d.getWidth() > d.getHeight () ) 


{ 
//---landscape mode--- 
Fragmentl fragmentl = new Fragmentl(í(); 
// android.R.id.content refers to the content 
// view of the activity 
fragmentTransaction.replace( 
android.R.id.content, fragmentl); 
} 
else 
{ 
//---portrait mode--- 
Fragment2 fragment? = new Fragment2(); 
fragmentTransaction.replace( 
android.R.id.content, fragment2); 
} 


//---add to the back stack--- 
fragmentTransaction.addToBackStack (null); 
fragmentTransaction.commit (); 


xx BA ft T SFC Fr SIE. Pay Dec Back 按钮 移 除 它 。 
2.3. A Zee TRA 

很 多 时 候 ， 一 个 活动 中 会 包含 一 个 或 者 多 个 碎片 ， 它 们 彼此 协作 ， 癌 用 户 展示 一 个 一 
致 的 UI。 在 这 种 情况 中 ,碎片 之 间 能 够 进行 通信 并 交换 数据 十 分 重要 。 例 如 ， 一 个 俱 片 可 
能 包含 一 个 项 目 列表 (例如 某 个 RSS 源 的 文章 )， 当 用 户 点 击 该 雁 上 请 中 的 某 个 项 时 ， 另 外 一 
个 健 片 中 会 显示 选中 项 的 细节 。 

下 和 面 的 “ 试 一 试 ” 演 示 了 一 个 人 肆 片 如 何 访问 男 一 个 人 肆 片 中 包含 的 视图 。 

试 一 试 碎片 之 间 的 通信 
a) 使 用 前 一 节 创 建 的 同一 个 项 目 ， 在 Fragmentl.xml 文件 中 添加 下 面 的 粗 体 代码 : 


<?xml version-"1.0" encoding-"utf-8"?» 
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<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background-"£$00FF00" > 

«TextView 
android: id="@+id/1lblFragment1" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android:text="This is fragment #1" 
android:textColor="#000000" 
android:textSize="25sp" /> 

</LinearLayout> 


(2) 1E fragment2.xml 中 添加 下 面 的 粗 体 代码 : 


<?xml version="1.0" encoding-"utfí-8"?» 

<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background-"£$FPFFEO0" > 

«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"This is fragment #2" 
android:textColor="#000000" 
android:textSize="25sp" /> 


<Button 
android: id="@+id/btnGetText" 
android: layout width-"wrap content" 
android: layout height="wrap content" 
android: text="Get text in Fragment #1" 
android: textColor="#000000" 
android:onClick="onClick" /> 


</LinearLayout> 


(3) TEES AP E Fr BTS DB) main.xml 中 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" > 


«fragment 
android:name-"net.learn2develop.Fragments.Fragment1l" 


Tf 
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android 
android 


android: 
android: 


<fragment 


android: 
android: 
android: 


android 


android: 


</LinearLayout> 


(4) 在 FragmentsActivity.java 文件 中 ， 注 释 掉 前 几 节 添加 的 代 但 。 修 改 之 后 ， 


应 该 如 下 所 示 : 


:id="@+id/fragment1i" 
:layout weight="1" 


layout width="0px" 
layout height="match parent" /> 


name="net.learn2develop. Fragments. Fragment2" 
id="@+id/fragment2" 
layout weight="1" 


:layout width="0px" 


layout height="match parent" /> 


public class FragmentsActivity extends Activity I 
/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super. onCreate (savedinstanceState) ; 


setContentView (R.layout.main) ; 


/* 


FragmentManager fragmentManager = getFragmentManager(); 


FragmentTransaction fragmentTransaction = 


fragmentManager.beginTransaction(); 


//---get the current display info--- 


WindowManager wm = getWindowManager (); 


Display 


d = wm.getDefaultDisplay(); 


if (d.getWidth() > d.getHeight()) 


Í 


//---landscape mode--- 


Fragmentl fragmentl = new Fragmentl (); 


// android.R.id.content refers to the content 


// view of the activity 


fragmentTransaction.replace( 


} 


else 


{ 


android.R.id.content, fragmentl); 


//---portrart mode 一 一 一 


Fragment? fragment2 = new Fragment2(); 


fragmentTransaction. replace ( 


} 


android.R.id.content, fragment2); 


//---add to the back stack--- 
fragmentTransaction.addToBackStack (null); 


fragmentTransaction.commit (); 


"x 


该 文件 
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(5) 在 Fragment2.java 文件 中 添加 下 面 的 粗 体 代 三 : 


package net.learn2develop.Fragments; 


import android.app.Fragment; 

import android.os.Bundle; 

import android.view.LayoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 
import android.widget.Button; 
import android.widget.TextView; 
import android.widget.Toast; 


public class Fragment2 extends Fragment { 
@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
//---Inflate the layout for this fragment--- 
return inflater.inflate( 
R.layout.fragment2, container, false); 


@Override 
public void onStart() { 
super.onStart(); 
//---Button view--- 
Button btnGetText - (Button) 
getActivity().findViewById (R.id.btnGetText); 
btnGetText.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
TextView lbl - (TextView) 
getActivity().findViewById(R.id.lblFragment1); 
Toast.makeText (getActivity(), lbl.getText(), 
Toast.LENGTH SHORT).show(); 


H); 


(6) T F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 在 右 侧 的 第 二 个 碎片 中 单 击 按钮 。 
可 以 看 到 Toast 类 显示 的 文本 This is fagment#1， 如 图 2-22 所 示 。 
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图 2-22 


示例 说 明 
因为 科 片 是 嵌入 在 活动 中 的 ,所 以 可 以 通过 先 使 用 getActivityQ T 15:3 £3 SITKA f 1 
碎片 的 活动 ， 然 后 使 用 fndViewById0 方 法 定位 该 碎片 中 包含 的 视图 : 
TextView lbl = (TextView) 
getActivity().findViewById(R.id.lblFragmentl); 


Toast.makeText(getActivity(), lbl.getText(), 
Toast.LENGTH SHORT).show(); 


getActivity() 77 23K ul 5; "8i fA: Fr RNA o 
另 一 种 方法 是 ， 在 FragmentsActivity.java 文件 中 添加 下 面 的 方法 : 
public void onClick(View v) { 
TextView lbl = (TextView) 
findViewById(R.id.lblFragmentl); 


Toast.makeText (this, lbl.getText(), 
Toast.LENGTH SHORT).show(); 


24 ”使 用 意图 调用 内 置 应 用 程序 


到 目前 为 止 ， 您 已 经 了 解 了 如 何在 自己 的 应 用 程序 中 调用 活动 。Android 编程 的 关键 
方面 之 一 就 是 使 用 意图 从 其 他 应 用 程序 中 调用 活动 。 特 别 是 ， 您 的 应 用 程序 可 以 调用 
Android 设备 内 置 的 许多 应 用 程序 。 例 如 ， 如 果 您 的 应 用 程序 需要 加 载 一 个 Web DII. 3 
可 以 使 用 Intent 对 象 调 用 内 置 的 Web 浏览 器 来 显示 该 页 面 ， 而 不 是 为 此 构建 自己 的 Web 
浏览 器 。 

下 面 的 “ 试 一 试 ” 将 演示 如 何 调用 Android 设备 中 一 些 常 见 的 内 置 应 用 程序 。 
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使 用 意图 调用 内 置 应 用 程序 


Intents.zip (CH X fF HJ EE Wrox.com E FR 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 并 命名 为 Intents。 
(2) 在 main.xml 文件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: 
android: 
android: 
android: 
android: 


id="@+id/btn_ webbrowser" 
layout width-"fill parent" 
layout height="wrap content" 
text="Web Browser" 
onClick="onClickWebBrowser" /> 


<Button 


android: id="@+id/btn_makecalls" 


android: 
android: 
android: 


layout width="fill parent" 
layout height-"wrap content" 
text="Make Calls" 


android:onClick-"onClickMakeCalls" /> 
<Button 

android: id="@+id/btn_showMap" 
:layout width="fill parent" 
:layout height="wrap content" 
: text=" Show Map" 


:onClick-"onClickShowMap" /> 


android 
android 
android 
android 


</LinearLayout> 

(3) f£ IntentsActivity.java XPFP ZIN F FAE Son ADT 5: 
package net.learn2develop.Intents; 
android.app.Activity; 


android.content.Intent; 
android.net.Uri; 


import 
import 
import 
import 
import 


android.os.Bundle; 
android.view.View; 


public class IntentsActivity extends Activity { 
int request Code - 1; 


ul i 


/** Called when the activity is first created. 
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@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


public void onClickWebBrowser (View view) { 
Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 
startActivity (i); 


public void onClickMakeCalls (View view) { 
Intent i = new 
Intent (android.content.Intent.ACTION DIAL, 
Uri.parse("tel:4651234567")); 
startActivity (i); 


public void onClickShowMap (View view) { 
Intent i = new 
Intent(android.content.Intent.ACTION VIEW, 
Uri.parse("geo:37.827500,-122.481670")); 
startActivity (i); 


} 

(4) 1Z F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 

(5) 单 击 Web Browser 按钮 在 模拟 器 中 加 载 Browser 应 用 程序 。 在 图 2-23 t}, 
Browser 应 用 程序 正在 显示 网 站 www.amazon.com, 

(6) 单 击 Make Calls 按钮 ， 加 载 Phone 应 用 程序 ， 如 图 2-24 所 示 。 


F F 
E: 556Andrid A0 Withklapa ”ISS nero 0 hM a 


E www.amazon.com/gp/aw: 


amazon.com 


Fp pear "xir Cart | Wish List 


1651234567 


19.22.3«. 


(Se. c € | Gc 
Search Amazon.com J W 


Eg Get heck for Android 


Kindle Fire 
Available 
Now 

Learn More 


Holiday Toy List 


Shop All Departments 


图 2-23 
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(7) 类 似 地 ， 单 击 Show Map 按钮 加 载 Maps 应 用 程序 ， 如 图 2-25 所 示 。 


示例 说 明 
本 例 中 ， 您 看 到 了 如 何 使 用 Intent 类 来 调用 Android 中 的 
- 些 内 管 应 用 程序 (例如 Maps. Phone. Contacts 和 Browser). 

在 Android 中 ， 意 图 通常 是 成 对 出 现 的 : 动作 (action) 和 数 
据 (data)。 动 作 描述 了 要 执行 什么 , 例如 编辑 一 个 条 日、 查看 一 
个 条 目的 内 容 等 。 数 据 则 指定 了 受 影 响 的 对 象 ， 例 如 Contacts 
数据 库 中 的 某 个 人 。 这 一 数据 被 指定 为 一 个 Uri 对 象 。 

动作 的 一 些 示例 如 下 : 

e ACTION VIEW 

e ACTION DIAL 

e ACTION PICK 

数据 的 一 些 示 例如 下 : 

e www.google.com 

e tel:+651234567 

e geo:37.827500, -122.481670 


e content://contacts 


注意 ;' 2.4.2 节 将 介绍 可 以 定义 并 在 活动 中 使 用 的 数据 类 型 ， 


动作 和 数据 对 共同 描述 了 要 执行 的 操作 ,例如 , 要 拨 一 个 电话 号 码 , 使 用 ACTION DIAL'/tel: 
+651234567 对 ; 要 显示 存储 于 手机 中 的 联系 人 列表 , 使 用 ACTION VIEW/content://contacts 
Xp; 要 从 联系 人 列表 中 选择 一 个 联系 人 ， 使 用 ACTION PICK/content://contacts 对 。 
在 第 1 个 按钮 中 ， 创 建 了 一 个 mtent 对 象 ， 然 后 给 它 的 构造 国 数 传递 了 两 个 参数 一 一 
动作 和 数据 : 
Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 
startActivity (1i); 
这 里 的 动作 由 android.content.Intent ACTION VIEW 第 量 表 示 。 使 用 Un 类 的 parse() 
方法 将 一 个 URL 字符 串 转 换 为 一 个 Un 对 象 。 
android.content.Intent ACTION VIEW 常量 实际 上 指 的 是 “android.intent.action.VIEW 
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动作 ， 所 以 前 述 代 码 可 以 重 写 为 ; 


Intent 1 = new 
Intent ("android.intent.action.VIEW", 
Uri.parse("http://www.amazon.com")); 
startActivity (1); 


前 面 的 代码 户 段 还 可 以 按 如 下 方式 改写 : 


Intent i = new 

Intent ("android.intent.action.VIEW") ; 
i.setData (Uri. parse("http://www.amazon.com") ) ; 
startActivity (i); 


在 这 里 ， 我 们 使 用 setData0 方 法 单独 设置 了 数据 。 
对 于 第 2 个 按钮 ， 我 们 通过 在 数据 部 分 传 入 一 个 电话 与 人 码 来 拨 出 一 个 特定 的 号 码 : 
Intent i = new 
Intent (android.content.Intent.ACTION DIAL, 


Uri.parse("tel:4651234567")); 
startActivity(1i); 


这 时 ， 拨 号 程序 将 显示 被 呼叫 的 号 码 。 用 户 仍旧 要 按 拨号 按钮 来 拨 出 这 个 号 码 。 如 果 
想 无 须 用 户 干 预 而 直接 拨 出 号 码 ， 则 要 修改 动作 如 下 : 
Intent i = new 
Intent (android.content.Intent.ACTION CALL, 


Uri.parse ("tel:+651234567")); 
startActivity (1); 


注意 : w RULARE FERYAD, FERARABA ARM 
android.permission.CALL PHONE 权限 。 


如 果 仅 仅 只 是 显示 拨号 程序 , AE ET SIS, 只 要 像 下 和 面 这 样 省 略 数据 部 分 即 可 : 


Intent I = new 
Intent (android.content.Intent.ACTION DIAL); 
startActivity (1); 


第 3 个 按钮 使 用 Action VIEW 币 量 显示 了 一 个 地 图 : 


Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse ("geo:37.827500,-122.481670") ) ; 
startActivity (1) ; 


这 里 ， 要 使 用 geo 模式 来 代替 http. 
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2.4.1 理解 意图 对 象 


到 目前 为 止 ， 您 已 经 了 解 了 Intent 对 象 调用 其 他 活动 的 作用 。 现 在 正好 可 以 回顾 一 下 
并 对 Intent 对 象 如 何 施展 它 的 上 魔力 获得 更 详细 的 认识 。 
首先 ， 我 们 可 以 通过 传递 一 个 动作 给 一 个 ntent 对 象 的 构造 函数 来 调用 另 一 个 活动 : 


startActivity (new Intent ("net.learn2develop.SecondActivity")); 


动作 (本 例 中 是 net.learn2develop.SecondActivity) 也 被 称 为 组 件 名 称 ， 用 来 标识 所 要 调 
用 的 目标 活动 /应 用 程序 。 也 可 以 通过 指定 存在 于 项 目 中 的 活动 的 类 名 修改 组 件 的 名 称 ， 如 
下 面 的 代码 所 示 : 


startActivity (new Intent (this, SecondActivity.class)); 


还 可 以 通过 传 入 一 个 动作 第 量 和 数据 来 创建 一 个 mtent 对 象 ， 例 如 : 
Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 
startActivity(i); 

动作 部 分 定义 了 您 要 干什么 ， 而 数据 部 分 包含 了 目标 活动 执行 的 数据 。 也 可 以 使 用 

setData0 方 法 传递 数据 给 Intent 对 象 : 
Intent 1 = new 
Intent ("android.intent.action.VIEW"); 
i.setData(Uri.parse("http://www.amazon.com")); 

在 本 例 中 , 您 表示 要 查看 指定 URL 的 Web 页 面 。 Android 操作 系统 会 查找 所 有 可 以 满 
足 您 要 求 的 活动 。 这 一 过 程 被 称 为 意图 解析 (intent resolution). 2.4.2 节 将 详细 讨论 您 的 活 
动 是 如 何 成 为 其 他 活动 的 目标 的 。 

对 于 某 些 意 图 是 无 须 指定 数据 的 。 例 如 ， 要 从 Contacts 应 用 程序 中 选择 一 个 联系 人 ， 
可 指定 该 动作 ， 然 后 使 用 setType0 方 法 表明 MIME 类 型 : 

Intent 1 = new 


Intent (android.content.Intent.ACTION PICK); 
1.setType (ContactsContract.Contacts.CONTENT TYPE); 


注意 : 第 7 章 将 讨论 如 何在 自己 的 应 用 程序 内 使 用 Contacts 应 用 程序 。 


setType0 方 法 显 式 指定 了 MIME 数据 类 型 来 表明 要 返回 的 数据 类 型 。ContactsContract. 
Contacts. CONTENT TYPE 的 MIME 类 型 是 vnd.android.cursor.dir/contact。 

除了 指定 动作 、 数 据 和 类 型 外 ，Intent 对 象 还 可 以 指定 类 别 。 将 活动 按 类 别 分 组 为 多 
辑 单 元 ， 可 以 实现 Android 对 活动 的 进一步 科 选 。 下 一 节 将 更 详细 地 讨论 类 别 。 
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总 的 来 说 ， 
e 动作 
. 数据 
e 类 型 
e Jl 


Intent 对 象 可 以 包含 以 下 信息 : 


2.4.2 ”使 用 意图 筛选 器 


之 前 ， 您 已 经 看 到 了 一 个 活动 是 如 何 使 用 Intent 对 象 调用 另 一 个 活动 的 。 为 了 使 其 他 
活动 调用 您 的 活动 ， 需 要 在 AndroidManifest.xml 文件 的 <intent-filter> 元 素 中 指定 动作 和 次 


nj, ON PHI: 


«intent-filter > 


«action android:name-"net.learn2develop.SecondActivity" /» 
«category android:name-"android.intent.category.DEFAULT" /» 


«/intent-filter-^ 


这 是 一 个 活动 使 用 net.learn2develop.SecondActivity 动作 调用 另 一 个 活动 的 非常 简单 的 


示例 。 下 面 的 


“ 试 一 试 ” 则 提供 了 一 个 更 复杂 的 示例 。 
更 详细 地 指定 意图 第 选 吕 


(1) 使 用 先前 创建 的 Intents 项 目 ， 给 该 项 目 添 加 一 个 新 类 ， 并 命名 为 MyBrowserActivity。 


在 res/layout X: 


件 严 下 再 新 增 一 个 XML 文件 ， 命 名 为 browser.xml. 


(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net.learn2develop.Intents" 


android:versionCode="1" 


android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


«uses-permission android:name-"android.permission.CALL PHONE"/> 


<uses-permission android:name-"android.permission.INTERNET"/» 


«application 


android:icon="@drawable/ic launcher" 
android:label-"8string/app name" > 
«activity 
android: label="@string/app name" 
android:name-".IntentsActivity" > 
<intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«activity android:name-".MyBrowserActivity" 
android: label="@string/app name"? 


第 2 章 ， 活动、 碎片 和 意图 

<intent-filter> 
«action android: name="android.intent.action.VIEW" /> 
<action android:name="net.learn2develop.MyBrowser" /> 
<category android: name="android.intent.category.DEFAULT" /> 
<data android:scheme="http" /> 

</intent-filter> 


«/activity» 


«/application» 
«/manifest» 


(3) 在 main.xml 文件 中 添加 下 列 粗 体 显示 的 代码 : 


<?xml version-"1.0" encoding-"utfí-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: 
android: 
android: 


«Button 
android: 


android 


android: 
android: 
android: 


«Button 
android: 
android: 


android 


android: 
android: 


«Button 
android: 
android: 
android: 
android: 
android: 


«Button 
android: 
android: 
android: 
android: 
android: 


layout width-"fill parent" 
layout height-"fill parent" 
orientation-" vertical" > 


id="@+id/btn webbrowser" 


:layout width-"fill parent" 


layout height-"wrap content" 
text-"Web Browser" 


/> 


onClick="onClickWebBrowser" 


id="@+id/btn makecalls" 
layout width-"fill parent" 


:layout height-"wrap content" 


text-"Make Calls" 


onClick-"onClickMakeCalls" /> 


id="@+id/btn showMap" 

layout width-"fill parent" 
layout height-"wrap content" 
text-"Show Map" 
onClick-"onClickShowMap" /> 


id="@+id/btn_ launchMyBrowser" 
layout width="fill parent" 
layout height-"wrap content" 
text="Launch My Browser" 


onClick-"onClickLaunchMyBrowser" /> 


</LinearLayout> 


(4) 在 IntentsActivityjava 文件 中 添加 下 列 粗 体 显示 的 语句 : 
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package net.learn2develop.Intents; 
import android.app.Activity; 
import android.content.Intent; 
import android.net.Uri; 
import android.os.Bundle; 
import android.view.View; 
public class IntentsActivity extends Activity | 


int request Code = 1; 


/** Called when the activity is first created. */ 


@Override 
public void onCreate (Bundle savedInstanceState) { j- } 
public void onClickWebBrowser (View view) | i- } 


public void onClickMakeCalls(View view) { ... } 
public void onClickShowMap (View view) { ... | 


public void onClickLaunchMyBrowser (View view) { 
Intent i = new 
Intent("net.learn2develop.MyBrowser"); 
i.setData(Uri.parse("http://www.amazon.com")); 
startActivity (1); 


) 


(5) 在 browser.xml 文件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout width-"fill parent" 
android: layout height="fill parent" > 
<WebView 
android: id="@+id/WebView01" 
android: layout width-"wrap content" 
android: layout height="wrap content" /> 
</LinearLayout> 


(6) 在 MyBrowserActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Intents; 
import android.app.Activity; 


import android.net.Uri; 
import android.os.Bundle; 


import android.webkit.WebView; 
import android.webkit.WebViewClient; 
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public class MyBrowserActivity extends Activity | 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedInstanceState) ; 
setContentView (R.layout.browser) ; 


Uri url = getIntent().getData(); 


WebView webView = (WebView) findViewById(R.id.WebViewO01); 
webView.setWebViewClient(new Callback(í()); 


webView.loadUrl(url.toString()); 


private class Callback extends WebViewClient { 


@Override 


public boolean shouldOverrideUrlLoading (WebView view, String url) { 


return (false); 


} 


(7) T& F11 BEE Android 模拟 器 上 调试 应 用 程序 。 

(8) fi; Launch my Browser 按钮 ， 将 会 看 到 显示 着 
Amazon.com 的 Web 页 面 的 一 个 新 活动 (如 图 2-26 所 示 )。 

示例 说 明 

在 本 例 中 ， 创 建 了 一 个 名 为 MyBrowserActivity 的 新 
活动 。 首 先 需要 在 AndroidManifest xml 文件 中 声明 它 。 


«activity android:name-".MyBrowserActivity" 
android: label="@string/app name" 
<intent-—filter> 
«action android: name="android.intent. 
action.VIEW" /> 
<action android:name="net.learn2develop. 
MyBrowser" /> 
<category android:name="android.intent. 
category.DEFAULT" /> 
<data android:scheme="http" /> 
«/intent-filter» 
«/activity» 


在 <intent-filter> 元 素 中 ， 声 明了 活动 的 两 个 动作 、 一 个 类 别 以 及 一 个 数据 。 这 意味 看 
所 有 其 他 活动 可 以 使 用 android.intent.action.VIEW £% net.learn2develop.MyBrowser 动作 来 调 
用 这 个 活动 。 对 于 所 有 希望 别人 使 用 startActivity0 或 startActivityForResult0 方 法 来 调用 的 
活动 ,它们 需要 具有 android.intent.category DEFAULT 类 别 。 如 果 没 有 的 话 ， 您 的 活动 将 不 


F 
3» 555b Android 4.0 


p Intents 


amazoncom | 


Price Check App 


Extra savings on December 10 


for Android 


Kindle Fire 
Avallable 


Now 
Wf ' Learn More 
Shop All Departments 


Books 


图 2-26 
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能 被 其 他 活动 调用 。<data> 元 素 指 定 了 活动 期 望 的 数据 类 型 。 在 本 例 中 ， 它 期 望 的 数据 要 
以 http:// 前 级 打头 。 
先前 的 意图 逢 选 需 还 可 以 按 如 下 方式 改 与 : 


«activity android: name=".MyBrowserActivity™"™ 
android: label="@string/app name"> 
<intent—-filter> 
«action android: name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category.DEFAULT" /> 
«data android:scheme-"http" /> 
«/intent-filter» 
«intent-filter- 
«action android:name-"net.learn2develop.MyBrowser" /» 
«category android:name-"android.intent.category.DEFAULT" /» 
«data android:scheme-"http" /» 
</intent—filter> 
«/activity» 


FIX PTT 3 2 5 A Fd Sie d. n]. EJOSE— P x E peas NE. KAAR EET E AH 
分 组 ， 使 其 更 加 具有 可 读 性 。 

现在 如 果 使 用 带 有 如 下 数据 的 ACTION VIEW 动作 ，Android 将 显示 一 个 选择 (如 图 
2-27 Pitan): 


Intent I = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 


可 以 在 使 用 Browser 应 用 程序 还 是 当前 正在 构建 的 Intents 


应 用 程序 间 进 行 选 择 。 

注意 ， 当 有 多 个 活动 匹配 Intent 对 象 时 ， 会 出 现 Complete 
action using 对 话 框 。 通 过 使 用 Intent 类 的 createChooser0 方 法 来 对 
该 对 话 框 进行 自 定 义 ， 如 下 所 示 : Misc dae 


= Browser 


Intent i = new 
Intent (android.content.Intent.ACTION p" Intents 

_ VIEW, 
Uri.parse ("http://www.amazon.com") ); 


Use by default for this action. 


startActivity (Intent.createChooser(i, "Open 
URL using...")); 


这 段 代 码 将 对 话 框 的 标题 改 为 Open URL using ..., 如 图 2-28 
所 示 。 注 意 ， 现 在 没有 了 Use by default for this action 选项 。 

使 用 createChooser0 的 男 一 个 好 处 是 , 当 没 有 活动 与 您 的 Intent 对 象 瞻 配 时 , 应 用 程序 
不 会 崩 沉 ， 而 是 会 显示 如 图 2-29 所 示 的 消息 。 


图 2-27 
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Open URL using... 


Browser Open URL using... 


| No applications can perform 
p Intents this action. 


图 2-28 2-29 
2.4.3 添加 类 别 


可 以 在 意图 生 选 器 中 使 用 <category> 元 素 对 活动 进行 分 类 。 假 设 已 经 在 AndroidMani- 
fest.xml 文件 中 添加 了 下 列 <category> 元 素 : 


<?xml version-"1.0" encoding="utf-8"?> 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Intents" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
«uses-permission android: name="android.permission.CALL PHONE"/> 
«uses-permission android:name="android.permission. INTERNET"/> 
<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
<activity 
android: label="@string/app name" 
android:name-".IntentsActivity" > 
<intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 


«activity android:name-".MyBrowserActivity" 
android:label-"8string/app name"» 
«intent-filter- 
«action android:name-"android.intent.action.VIEW" /> 
«action android:name-"net.learn2develop.MyBrowser" /» 
«category android:name-"android.intent.category.DEFAULT" /» 
«category android:name-"net.learn2develop.Apps" /> 
«data android:scheme="http" /> 
«/intent-filter» 
<factivity> 
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</application> 


</manifest> 


在 这 种 情况 下 ， 下 列 代码 将 调用 MyBrowserActivity 活动 : 


Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse ("http://www.amazon.com") ) ; 
1.addCategory ("net.learn2develop.Apps") ; 
startActivity (Intent.createChooser(i, "Open URL using...")); 


使 用 addCategory0 方 法 将 类 别 添加 到 Intent WHA. Wie S addCategoryO 语 句 ， 
前 述 的 代码 仍旧 会 调用 MyBrowserActivity 活动 ， 因 为 它 仍旧 和 默认 类 别 android intent.category. 
DEFAUIT 匹配 。 

不 过 , 如 果 指 定 了 一 个 和 意图 科 选 需 中 定义 的 类 别 不 匹配 的 类 别 , 活动 将 不 会 被 调用 : 


Intent I = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 
//i.addCategory ("net.learn2develop.Apps") ; 
//---this category does not match any in the intent-filter--- 
1.addCategory ("net.learn2develop.OtherApps") ; 
startActivity (Intent.createChooser(i1i, "Open URL using...")); 


XRAY JI (net.learn2develop.OtherApps) Á^ UL fic zx A $i 3c s FAY HERI RG, 所 以 如 果 不 
使 用 Intent 类 的 createChooser0 方 法 ， 将 引发 一 个 运行 时 异常 。 
如 果 在 MyBrowserActivity 的 意图 科 选 器 中 添加 前 述 类 别 ， 先 前 的 代码 束 可 以 运行 了 : 


«activity android:name-".MyBrowserActivity" 
android:label-"8string/app name"> 
«inLent-iilter- 
«action android:name-"android.intent.action.VIEW" /> 
«action android:name-"net.learn2develop.MyBrowser" /» 
«category android:name-"android.intent.category.DEFAULT" /» 
«category android:name-"net.learn2develop.Apps" /» 
Xcategory android:name-"net.learn2develop.OtherApps" /» 
«data android:scheme-"http" /» 
«/intent-filter» 
«/activity» 


可 以 添加 多 个 类 别 到 一 个 Intent 对 象 中 , 以 下 语句 在 Intent 对 象 中 添加 了 netlearn2develop 
SomeOtherApps 类 别 : 


Intent i = new 
Intent (android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")); 
//i.addCategory("net.learn2develop.Apps"); 
//---this category does not match any in the intent-filter--- 
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1.addCategory ("net.learn2develop.OtherApps"); 
1.addCategory ("net.learn2develop.SomeOtherApps") ; 
startActivity(Intent.createChooser(i, "Open URL using...")); 


HT x Alive 472-7 EX net.learn2develop.SomeOtherApps 类 别 ， 上 述 代 码 将 不 能 1 
用 MyBrowerActivity 752). Ast, qs 22 Fi UAI net.learn2develop.SomeOtherApps X J| 
Sex A AS o 

从 这 个 示例 可 以 看 出 ， 在 一 个 活动 可 以 被 调用 之 前 ， 当 使 用 一 个 市 有 类 别 的 Intent 对 
象 时 ， 所 有 添加 到 Intent 对 象 的 类 别 必 须 完 全 匹配 意图 筛选 器 中 所 定义 的 类 别 。 


2.5 显示 通知 


到 目前 为 止 ， 您 一 直 使 用 Toast 类 来 给 用 户 显 示 消 息 。Toast 类 虽然 是 一 个 同 用 户 显 示 
STRATEN TE, (LUDA. ER TEs EEA AB JUPPPIUBSSUH TRIS Hr n 
RA BA bees, HEPES SRE RM, MIRA Die. 

对 于 重要 的 消息 ,要 使 用 更 加 持久 的 方法 。 这 种 情况 下 , 应 当 使 用 NotificationManager 
在 设备 顶端 的 状态 栏 (有 时 也 称 为 通知 栏 ) 中 显示 一 条 持久 化 的 信息 。 下 面 的 “ 试 一 试 ” 沉 
示 了 如 何 做 到 这 一 点 。 


eH LT 


Notifications.zip fCfZ X ff A] LA FE Wrox.com E F3 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 并 命名 为 Notifications. 

(2) 在 包 中 添加 一 个 新 的 类 文件 Notifications.zip。 男 外 ， 在 res/ layout 文件 夹 下 添加 
个 新 的 notification.xml 文件 。 

(3) 按 如 下 所 示 填 充 notification.xml 文件 : 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout width-"fill parent" 
android: layout height-"fill parent" > 
<TextView 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Here are the details for the notification..." /> 


</LinearLayout> 
(4) 按 如 下 所 示 填 充 NotificatonView.java 文件 : 
package net.learn2develop.Notifications; 


import android.app.Activity; 
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import android.app.NotificationManager ; 
import android.os.Bundle; 


public class NotificationView extends Activity 
{ 
@Override 
public void onCreate (Bundle savedInstanceState) 
{ 
super. onCreate (savedinstanceState) ; 
setContentView(R.layout.notification); 


//---look up the notification manager service--- 
NotificationManager nm — (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 


//---cancel the notification that we started--- 
nm.cancel(getIntent().getExtras().getInt("notificationID")); 


) 
(5) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Notifications" 
android:versionCode-"]" 
android:versionName-"1].0" > 


«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android:name-"android.permission.VIBRATE"/» 


«application 

android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

<activity 
android: label="@string/app name" 
android:name-".NotificationsActivity" > 
<intent-filter > 

<action android:name="android.intent.action.MAIN" /> 


«category android:name="android.intent.category. LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«activity android:name=".NotificationView" 
android: label="Details of notification"> 
<intent-filter> 
«action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
«/activity» 
</application> 


</manifest> 
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(6) 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?- 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


android:orientation="vertical™ > 


<Button 
android: id="@+id/btn_ displaynotif" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Display Notification" 
android: onClick="onClick"/> 
</LinearLayout> 


(7) 最 后 ， 在 NotificationsActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Notifications; 


import 
import 
import 
import 
import 
import 
import 


android 


android. 
android. 
android. 


android 


android. 
android. 


-app.Activity; 

app .Notification; 

app .NotificationManager ; 
app.PendingIntent; 
.Content.Intent; 
os.Bundle; 

view.View; 


public class NotificationsActivity extends Activity { 


int notificationID - 1; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super. 


onCreate(savedInstanceState); 


setContentView(R.layout.main); 


public void onClick(View view) { 
displayNotification(); 


protected void displayNotification() 


{ 


//---PendingIntent to launch activity if the user selects 
// this notification--- 


Intent i = new Intent(this, NotificationView.class); 
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1.putExtra("notificationID", notificationID); 


PendingIntent pendingIntent = 
PendingIntent.getActivity(this, O, i, 0); 


NotificationManager nm = (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 


Notification notif - new Notification( 
R.drawable.ic launcher, 
"Reminder: Meeting starts in 5 minutes", 
System.currentTimeMillis()); 


CharSequence from — "System Alarm"; 
CharSequence message = "Meeting with customer at 3pm..."; 


notif.setLatestEventInfo(this, from, message, pendingIntent); 


//---100ms delay, vibrate for 250ms, pause for 100 ms and 
// then vibrate for 500ms--- 

notif.vibrate = new long[] { 100, 250, 100, 500}; 
nm.notify (notificationID, notif); 


} 
} 
(8) 按 F11 $&fE Android 模拟 右上 调试 应 用 — eme 
程序 。 p Reminder: Meeting starts in 5 
(9) 单 击 Display Notification 按钮 ， 状 态 栏 上 Notifications 


将 出 现 一 个 通知 的 深 动 文本 (在 Notification 对 象 
的 构造 函数 中 设置 )， 如 图 2-30 所 示 。 

(10) 单 击 并 向 下 拖 忠 状态 栏 将 显示 使 用 图 2-30 
Notification 对 象 的 setLatestEventInfo0 方 法 设置 的 通知 细节 ， 如 图 2-31 Aras. 

(11) 单 击 通 知 将 显示 NotificationView 活动 ， 如 图 2-32 所 示 。 同 时 也 将 把 通知 从 状态 
栏 上 清除 。 


7 
a 5554: ndroid 40 


Display Notification 


December 8, 2011 


rr 5554: mdiroic 4.0 
System Alarm 


Meeting with customer at 3pm... 


P Details of notification 


Android 


Here are the details for the notification.. 


图 2-32 
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示例 说明 
要 显示 一 个 通知 ， 首 先 要 创建 一 个 指 问 NotificationView 类 的 Intent 对 有 象 : 
Intent i = new Intent(this, NotificationView.class); 
1.putExtra("notificationID", notificationID); 
当 用 户 从 通知 列表 中 选择 了 一 个 通知 时 ， 这 个 意图 将 被 用 来 启动 另 一 个 活动 。 在 这 个 
示例 中 ， 给 Intent 对 象 添加 一 个 键 / 值 对 以 便 可 以 用 来 标记 通知 ID， 标识 目标 活动 的 通知 。 
这 个 ID 将 在 以 后 用 来 撤销 这 个 通知 。 


还 需要 创建 一 个 PendingIntent 对 象 。PendingIntent 对 象 可 以 代表 应 用 程序 帮助 您 在 后 面 某 


个 时 候 执行 一 个 动作 ， 而 不 用 考虑 应 用 程序 是 否 正在 运行 。 在 这 里 ， 按 如 下 所 示 初 始 化 它 : 


PendingIntent pendingIntent = 
PendingIntent.getActivity(this, 0, 1, 0); 


getActivity0 方 法 检索 一 个 PendingIntent 对 象 并 使 用 如 下 参数 设置 它 : 

e EFX 应 用 程序 上 下 文 

e ick ——)H] 3 x E) i SK 

e 意图 一 一 用 来 启动 目标 活动 的 意图 

e 标志 一 一 活动 启动 时 使 用 的 标志 

然后 ， 获 取 一 个 NotificationManager 类 的 实例 并 创建 一 个 Notification 类 的 实例 : 


NotificationManager nm = (NotificationManager) 
getsSystemService (NOTIFICATION SERVICE); 


Notification notif = new Notification ( 
R.drawable.ic launcher, 
"Reminder: Meeting starts in 5 minutes", 
System. currentTimeMillis()); 


当 通 知 首次 显示 在 状态 栏 上 时 ，Notification 类 使 您 能 人 够 指定 通知 的 主要 信息 。 
Notification 构造 函数 的 第 二 个 参数 在 状态 栏 上 设置 了 “滚动 文本 ”( 如 图 2-33 所 示 )。 


8. 35354Android_40 


p Reminder: Meeting starts in 5 


2:33 


接 下 来 ， 使 用 setLatestEventInfoO 方 法 来 设置 通知 的 详细 内 容 : 


CharSequence from = "System Alarm"; 
CharSequence message = "Meeting with customer at 3pm..."; 


notif.setLatestEventInfo(this, from, message, pendingIntent); 


//---100ms delay, vibrate for 250ms, pause for 100 ms and 
// then vibrate for 500ms--- 
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notif.vibrate = new long[] { 100, 250, 100, 500}; 
上 述 代 码 还 将 通知 设置 为 震动 手机 。 最 后 ， 使 用 notifyO 方 法 来 显示 通知 。 
nm.notify(notificationID, notif); 


当 用 户 单 击 通 知 时 ，NotificationView 活动 就 会 启动 。 这 里 ， 使 用 NotificationManager 
对 象 的 cancel0 方 法 并 传递 给 它 通 知 的 ID( 通 过 Intent 对 象 传递 ) 来 取消 这 个 通知 : 


//---look up the notification manager service--- 

NotificationManager nm = (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 

//---cancel the notification that we started--- 


nm.cancel(getIntent().getExtras().getInt("notificationID")); 


26 本章 小 结 


本 章 首先 详细 介绍 了 活动 和 碎片 是 如 何 工作 的 以 及 用 于 显示 它们 的 各 种 形式 。 您 还 了 
解 了 如 何 使 用 活动 来 显示 对 话 框 窗口 。 

本 章 第 二 部 分 阐述 了 Android 中 的 一 个 非常 重要 的 概念 一 一 意图 。 意 图 是 使 不 同 活动 
连接 起 来 的 “胶水 ” 也 是 为 Android 平台 进行 开发 需要 了 解 的 一 个 关键 概念 。 


1. 如 果 有 两 个 或 多 个 活动 具有 相同 的 意 网 簿 选 器 动作 名 称 ， 那 将 会 发 生 什 么 ? 
2. 写 一 段 代 码 来 调用 内 置 的 Browser 应 用 程序 。 

3. 在 意图 科 选 堪 中 ， 可 以 指定 哪些 组 成 部 分 ? 

A. Toast 类 和 NotificationManager 类 的 区 别 是 什么 ? 

5. 列举 在 活动 中 添加 全 上 请 的 两 种 方法 。 

6. ji B AE FORTES S] 1 DR XC 33] 

练习 答案 参见 附录 C. 


本 章 主 要 内 容 
to m 关键 概念 
创建 活动 所 有 活动 必须 在 AndroidManifestxml 文件 中 声明 
| "" 当 活 动 启动 时 ， 总 是 调用 onStart0 和 onResume0O 事 件 。 当 活动 被 停止 
活动 的 关键 生命 周期 
或 转 入 后 台 时 ， 总 是 调用 onPause0 事 件 
以 对 话 框 形式 显示 活动 使 用 showDialog0 方 法 并 实现 onCreateDialog( 77 3: 
PEJT 碎片 是 可 以 在 活动 中 添加 或 移 除 的 “ 微 活动 ” 
在 运行 时 添加 、 移 除 或 替换 碎片 时 ， 需 要 使 用 FragmentManager 和 
以 编程 方式 操作 碎片 " she e tn 
FragmentTransaction 类 


to mH 
健 片 的 生命 周期 


意图 

X Ed ff oc s 

调用 活动 
传递 数据 给 一 个 活动 
Intent 对 象 中 的 组 成 部 分 
显示 通知 


PendingIntent 对 象 
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CI 
关键 概念 
关 似 于 活动 的 生命 周期 一 在 onPause0 事 件 中 保存 碎片 的 状态 , 在 下 面 的 
某 个 事件 中 还 原 其 状态 : onCreate0、onCreateView0 或 onActivityCreated0O 
连接 不 同 活动 的 “胶水 ” 
可 以 使 您 指定 应 当 如 何 调用 活动 的 “筛选 器 ” 
使 用 startActivity0 或 startActivityForResult0 方 法 
使 用 Bundle 对 象 
Intent 对 象 包 仿 动作、 数据、 类 型 和 类 别 
使 用 NotificationManager 类 
PendingIntent 对 象 可 以 代表 应 用 程序 帮助 您 在 后 面 某 个 时 候 执行 一 个 
动作 ， 而 不 用 考虑 应 用 程序 是 否 正在 运行 
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本 章 将 介绍 以 下 内 容 : 

e 可 以 用 来 布局 视图 的 多 种 视图 组 (ViewGroup) 
e ”如何 适 应 和 管理 屏 医 方 同 的 变化 

e 如 何以 编程 方式 创建 用 户 界 面 

e 如 何 侦 听 用 户 界 面 通知 


在 第 2 章 中 ， 您 已 经 学 习 了 Activity 类 和 它 的 生命 周期 ， 了 解 了 活动 就 是 用 户 用 来 和 
应 用 程序 交互 的 一 个 手段 。 然 而 ， 活 动 本 身 并 没有 在 屏幕 上 呈现 。 相 反 ， 筷 需要 使 用 视图 
和 视图 组 来 绘制 屏幕 。 本 章 将 学 习 有 关 在 Android 中 创建 用 户 界面 的 详细 内 容 ， 以 及 用 户 
是 如 何 与 之 交互 的 。 此 外 ， 还 将 学 习 如 何 处 理 Android 设备 屏 医 方向 的 变化 。 


3.1 了 解 屏 幕 的 构成 


在 第 2 章 中 ， 您 已 经 知道 了 Android 应 用 程序 的 基本 单元 是 活动 。 活 动 显示 了 应 用 程 
序 的 用 户 界 面 ， 它 可 以 包含 按钮 、 标 签 、 文 本 框 等 小 部 件 。 通 币 情 况 下 ， 使 用 一 个 XML 
文件 (例如 ， 位 于 res/layout 文件 夹 下 的 main.xml 文件 ) 来 定义 用 户 界面 ， 类 似 如 下 所 示 : 


<?xml version="1.0" encoding-"utí-8"?-2 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<TextView 
android: layout width-"fill parent" 
android:layout height="wrap content" 
android:text="@string/hello" /> 
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</LinearLayout> 


运行 时 , 在 Activity 类 的 onCreate0 方 法 处 理 程序 中 使 用 Activity 类 的 setContentView() 
方法 加 载 XML 用 户 界面 : 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


} 


在 编译 过 程 中 ，XML 文件 中 的 每 一 个 元 素 被 编译 成 相应 的 Android GUI 类， 这 些 类 使 
用 方法 来 表示 属性 。 在 此 文件 被 加 载 后 ，Android 系统 就 会 创建 活动 的 用 户 界 面 。 


注意 : 尽管 使 用 XML 文件 构建 用 户 界面 通常 比较 容易 ， 但 有 时 您 还 需要 在 运 
行 时 动态 地 构建 用 户 界面 (例如 ， 编 写 游 戏 时 )。 因 此 ， 完 全 用 代码 创建 用 户 界 
面 也 是 可 行 的 方法 。 本 章 稍 后 将 为 您 提供 一 个 示例 ,演示 是 如 何 实现 这 一 点 的 。 


3.1.1. 视图 和 视图 组 


活动 包含 了 视图 和 视图 组 。 视 图 是 一 个 可 以 在 屏 磋 上 显现 的 小 部 件 ， 例 如 按钮 、 标 等 
和 文本 框 。 视 图 派生 目 基 类 android.view. View. 


注意 : 第 4 章 和 第 5 章 将 讨论 Android 中 各 种 常见 的 视图 . 


-个 或 多 个 视图 可 以 组 合成 一 个 视图 组 。 视 图 组 (其 本 身 就 是 一 种 特殊 的 视图 类 型 ) 提 
供 了 一 种 布局 ， 您 可 以 按 该 布局 定制 视图 的 外 观 和 顺序 。 视 图 组 的 例子 包括 LinearLayout 
和 FrameLayout。 视 图 组 派生 于 基 类 android.view.ViewGroup。 
Android 文 持 以 下 视图 组 : 


e LinearLayout 

e AbsoluteLayout 
e TableLayout 

e RelativeLayout 
e FrameLayout 


è ScrollView 


在 后 面 的 章节 中 将 对 这 每 一 个 视图 组 进行 详细 讨论 。 注 意 ， 在 实践 中 将 不 同类 型 的 布 
局 组 合 起 来 创建 想 要 的 用 户 界 面 是 很 常见 的 。 
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3.1.2 LinearLayout 


LinearLayout 是 以 单行 或 单列 的 形式 排列 视图 的 。 子 视图 可 以 水 平 或 垂直 地 排列 。 要 
了 解 LinearLayout 是 如 何 工 作 的 ， 请 考虑 main.xml 文件 中 通常 包含 的 以 下 元 素 : 


<?xml version-"1.0" encoding-"utfí-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 


android:text="@string/hello" /> 
</LinearLayout> 


在 mainxml 文件 中 ， 可 注意 到 根 元 素 <LinearLayout> 及 其 包含 的 <TextView> 元 素 ， 
<LinearLayout> 元 素 用 来 控制 其 所 包含 的 视图 的 显示 顺序 。 
每 个 视图 和 视图 组 都 有 一 组 公共 属性 ， 其 中 一 些 如 表 3-1 所 示 。 


表 3-1 视图 和 视图 组 使 用 的 公共 属性 


属 性 fe 述 
layout width 指定 视图 或 视图 组 的 宽度 
layout height 指定 视图 或 视图 组 的 高 度 
layout marginTop 指定 视图 或 视图 组 顶 边 额 外 的 空间 
layout marginBottom fig re OLS p E RHR 1 Bib A E 
layout marginLeft 指定 视图 或 视图 组 左边 额外 的 空间 
layout_marginRight 指定 视图 或 视图 组 右边 额外 的 空间 
layout gravi 指定 如 何 定位 子 视图 
layout weight 指定 在 布局 中 应 该 给 视图 分 配 多 少 额 外 空间 
layout x 指定 视图 或 视图 组 的 x 坐标 
layout y 指定 视图 或 视图 组 的 y 坐标 


注意 : 以 上 菜 些 属 性 只 有 当 一 个 视图 在 特定 的 视图 组 中 时 才 适 用 。 例 如 ， 
layout weight 和 layout gravity 属性 只 适用 于 视图 位 于 LinearLayout 或 
TableLayout 视图 组 中 的 情况 。 


举例 来 说 ， 使 用 fill parent 常量 可 以 让 <TextView> 元 素 的 宽度 填 满 其 父 元 素 ( 本 例 中 指 
Deter) RET FRE. wrap content 和 常量 表明 了 其 高 度 就 是 其 内 容 ( 本 例 中 指 其 包含 的 文本 ) 的 
高 度 。 如 果 不 打 算 让 <TextView> 视 图 占据 一 整 行 ， 可 以 将 其 layout width 属性 设置 为 
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wrap_content， 如 下 所 示 : 


<TextView 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 


这 将 把 视图 的 宽度 设 为 此 视图 所 包含 的 文本 的 宽度 。 
考虑 以 下 布局 : 
<?xml version-"1.0" encoding="utf-8"?> 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<TextView 
android: layout width="100dp" 
android: layout height-"wrap content" 
android: text="@string/hello" /> 


<Button 
android: layout width="160dp" 
android: layout height="wrap content" 
android: text="Button" 
android: onClick="onClick" /> 


</LinearLayout> 


度量 单位 

当 指 定 Android 用 户 界 面 上 元 素 的 大 小 时 ， 应 知道 以 下 上 度量 单位 : 

dp 一 一 与 密度 无 关 的 像素 (density-independent pixel)。1dp 相当 于 160dpi 的 屏幕 上 的 1 
像素 。 当 在 布局 中 指定 视图 尺寸 时 ,推荐 将 dp 作为 度量 单位 。160dpi 是 Android 假定 的 基 
准 密度 。 当 指 的 是 与 密度 无 关 的 像素 时 ， 可 以 使 用 dp 或 dip。 

sp 与 比例 无 关 的 像素 (scale-independent pixel). 5 dp 类 似 ， 推 荐 用 于 指定 字体 
大 小 。 

pt 一 一 傍 。1 磅 等 于 1/72 英寸 (基于 屏幕 的 物理 尺寸 )。 

px 一 一 像素 。 对 应 于 屏幕 上 的 实际 像素 。 不 建议 使 用 这 一 单位 ， 因 为 您 的 用 户 界 面 在 
不 同 屏 幕 扩 寸 的 设备 上 可 能 不 能 正确 呈现 。 


XE, 将 TextView 和 Button 视图 的 宽度 都 设置 成 了 一 个 绝对 值 。 在 本 例 中 ，TextView 
的 宽度 被 设置 为 100dp， Button 的 宽度 被 设置 为 160dp。 在 具有 不 同 像素 密度 的 不 同 屏幕 上 
查看 这 些 视 图 的 效果 时 ， 理 解 Android 如 何 识别 具有 不 同 尺 寸 和 密度 的 屏幕 十 分 重要 。 

图 3-1 展现 了 Nexus S 的 屏幕 。 它 有 一 个 4 英寸 的 屏 疾 ( 按 对 角 线 计算 )， 屏 幕 宽 度 为 


2.04 英寸 。 它 的 分 辨 率 为 480( 宽 度 )X 800( 高 度 ) 像 素 。 将 480 像素 分 布 到 2.04 英寸 的 宽度 
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上 ， 结 果 就 是 像素 密度 大 约 为 235dpi。 
从 图 中 可 以 看 到 ， 屏 幕 的 像素 密度 会 随 者 屏幕 尺寸 
和 分 辩 率 发 生变 化 。 — 
Android 定义 并 可 识别 4 种 屏幕 密度 : 


e (2 E dpi) ——120dpi 

e 中 等 密度 (mdpi) 一 一 160dpi Ne 
e 高 密度 (hdpi) 一 一 240dpi | == 

e 超 高 密度 (xhdpi) 一 一 320dpi 


您 的 设备 的 屏幕 密度 会 是 上 面 列表 中 的 一 个 。 例 E 0 pne 
Wl, Nexus S 被 认为 是 一 种 hdpi 设备 ， 因 为 它 的 像素 密 eee 
度 最 接近 240dpi. Ai, HTC Hero 的 屏幕 尺寸 为 3.2 3X es 
寸 ( 按 对 角 线 计算 )， 分 辨 率 为 320X480， 因 此 其 像素 密 
度 大 约 为 180dpi。 因 为 这 个 像素 密度 最 接近 160dpi， 所 
LJ HTC Hero 被 认为 是 一 种 mdpi 设备 。 图 3-1 


TTE LI 
T 
UOCE 


为 了 测试 当 XML 文件 中 定义 的 视图 显示 在 不 同 密度 的 屏幕 上 时 效果 如 何 ， 创 建 两 个 
有 具有 不 同 屏幕 分 辨 率 和 abstracted LCD 密度 的 AVD。 图 3-2 显示 了 一 个 分 辨 率 为 480X800、 


LCD 密度 为 235 的 AVD, ERT Nexus S. 


图 3-3 显示 了 另 一 个 AvVD, 它 的 分 辩 率 为 320X480, LCD 密度 为 180, 模拟 了 HTC Hero. 


a AVD details _— | E` AVD details 


Mame: Galaxy Mexus 5 dpi 735 Name: Hero dpi 180 
CPU/ABE ARM (armeabi) CPU/ABE ARM (armeabi) 
Path: CAUsersVWei-Meng Lee\..android\avd\ Galaxy Nexus 5 dpi 235.avd Path: C:\Users\We-Meng Leex.androidyavdXHero dpi 180.avd 
Target: Android 2.3.3 (API level 10) Target: Android 2.2 (API level 8) 
Skin: 480x800 Skin: 320x480 


hw.lcd.density: 235 hw.lcd.density: 180 


vm.heapSize; 24 vm.heapSize: 24 
hw.ramSize: 256 


3-2 3-3 


图 3-4 显示 了 在 屏幕 的 像素 密度 为 235dpi 的 模拟 器 中 ， 视 图 看 起 来 是 什么 样子 。 
图 3-5 显示 了 在 屏幕 的 像 隶 密度 为 180dpi 的 模拟 器 中 ， 视 图 看 起 来 是 什么 样子 。 


使 用 dp 单位 确保 了 无 论 屏 幕 密度 如 何 ， 视 图 总 是 会 以 正确 的 比例 显示 ， 这 是 因为 
Android 会 根据 屏幕 的 密度 上 自动 缩放 视图 的 尺寸 。 以 Button 为 例 。 如 果 它 在 一 个 180dpi 的 
屏幕 上 显示 (180dpi 的 屏幕 会 被 当做 160dpi 的 屏幕 进行 处 理 ),， 则 宽度 将 是 160 RA. 但是， 
如 果 在 一 个 235dpi 的 屏 医 上 显示 (23Sdpi 的 屏幕 会 被 当做 240dpi 的 屏幕 处 理 ), 那么 宽度 将 


是 240 像素 。 
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wM 2:22 PM 


Button 


Button 


图 3-5 

如 何 将 dp 转换 为 px 

将 dp 转换 为 px( 像 素 ) 的 公式 如 下 : 

实际 像素 =dp*(dpi/160)， 其 中 dpi 可 以 是 120、160、240 或 320. 

因此 , 当 Button 显示 在 一 个 235dpi 的 屏幕 上 时 ,其 实际 宽度 是 160 * (240/160) = 240 px. 
当 运 行 在 180dpi 的 模拟 需 中 (被 视 为 160dpi 的 设备 ) 时 ， 其 实际 像 隶 则 是 160 * (160/160) = 
160 px。 在 本 例 中 ，1dp 等 于 1px。 

为 了 证 明 这 是 正确 的 ， 可 以 使 用 View WRAY getWidth0 方 法 获得 其 以 像素 数 表示 的 宽度 : 

public void onClick(View view) 1 
Toast.makeText (this, 


String .valueot (view.getWidth{()}, 
Toast. LENGTH LONG) .show (); 


} 
如 果 不 使 用 dp， 而 是 使 用 像素 (px) 指 定 尺 寸 ， 又 会 怎样 ? 
<TextView 


android:layout width="100px" 
android:layout height="wrap content" 
android:text="@string/hello" /> 
<Button 
android:layout width="160px" 
android:layout height="wrap content" 
android:text-"Button" 
android:onClick-"onClick"/» 
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图 3-6 显示 了 Label 和 Button 在 235dpi BÉ] Bé ERR. KI 3-7 显示 了 相同 的 视图 在 
180dpi 屏幕 上 的 外 观 。 在 本 例 中 ， 因 为 所 有 的 尺寸 都 是 使 用 像素 指定 的 ， 所 以 Android 不 
会 执行 任何 转换 。 一 般 来 说 ， 当 屏幕 尺寸 相同 时 ， 如 果 使 用 像素 指定 视图 的 尺寸 ， 那 么 与 
HAIR dpi 的 屏幕 的 设备 相 比 ， 视 图 在 具有 高 dpi 屏幕 的 设备 上 会 显得 更 小 。 


x wi B 2:55 


ello Worlc 
Button LayoutsActivity! 
Button 


图 3-6 图 3-7 


上 面 的 例子 还 指定 了 布局 的 方向 是 垂直 的 : 


<LinearLayout xmlns:android="http://schemas. 
android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" Hello Warld Button 
android:orientation-"vertical" » peter 


B Layouts 


默认 的 布局 方向 是 横向 的 。 因 此 ， 如 果 省 略 android: 
orient- ation 属性 ， 视 图 将 显示 如 图 3-8 所 示 的 效 来 。 

在 LinearLayout 中 ， 可 以 对 其 中 包含 的 视图 应 用 
layout weight 和 layout gravity Jatt, AS main.xml X: 
件 作 如 下 修改 : 


<LinearLayout 
xmins:android-"http://schemas.android.com/ap 
k/res/android" 

android:layout width-"fill parent" 

android:layout height-"fill parent" Xl 3.8 


android:orientation-"vertical" > 
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<Button 
android:layout width="160dp" 
android:layout height="wrap content" 
android: text="Button" 
android:layout gravity="left" 
android:layout weight="1" /> 


<Button 
android: layout width="160dp" 
android: layout height-"wrap content" 
android: text="Button"™ 
android: layout gravity="center" 
android:layout weight="2" /> 


<Button 
android:layout width-"l60dp" 
android:layout height-"wrap content" 
android:text-"Button" 
android:layout gravity-"right" 
android:layout weight-"3" /» 


</LinearLayout> 


图 3-9 显示 了 视图 的 位 置 及 其 高 度 。layout-gravity 属性 指定 了 视图 应 该 朝 着 哪个 方向 
移动 ， 而 layout weight 属性 指定 了 可 用 空间 的 分 布 情况 。 在 前 面 的 示例 中 ，3 个 按钮 分 别 
占据 了 可 用 高 度 的 16.6%(1/(1+2+3)*100)、33.3%(2/(1+2+3)*100) 和 50%(3/(1+2+3) *100). 

如 果 将 LinearLayout 的 方 同 改 为 横 同 ， 就 需要 将 每 个 视图 的 宽度 改 为 0dp， 此 时 视图 
的 显示 情况 如 图 3-10 所 示 。 


Td rad rodd 4.0 


"m Layouts " Layouts 


But Button Button 
ton 


Button 


Button 


Button 


图 3-9 图 3-10 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"fill parent" 
android:layout height-"fill parent" 
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android:orientation="horizontal" > 


<Button 
android: layout width-"Odp" 
android: layout height="wrap content" 
android: text="Button"™ 
android: layout gravity="left" 
android: layout weight="1" /> 


<Button 
android: layout width-"Odp" 
android: layout height="wrap content" 
android: text="Button"™ 
android: layout gravity-"center horizontal" 
android: layout weight="2" /> 


<Button 
android: layout width-"Odp" 
android: layout height="wrap content" 
android: text="Button"™ 
android: layout gravity-"right" 
android: layout weight="3" /> 


</LinearLayout> 


3.1.3 AbsoluteLayout 


AbsoluteLayout 可 用 于 指定 其 子 元 素 的 确切 位 置 。 考 虑 下 列 main.xml 文件 中 定义 的 用 
户 界 面 : 


<AbsoluteLayout 
android: layout width-"fill parent" 
android: layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" > 
<Button 
android: layout width="188dp" 
android: layout height-"wrap content" 
android: text="Button" 
android: layout x-"l126px" 
android:layout y="36lpx" /> 
<Button 
android: layout width="113dp" 
android: layout height-"wrap content" 
android: text="Button" 
android: layout x-"l2px" 
android:layout y-"36lpx" /> 
«/AbsoluteLayout» 


图 3-11 展示 了 使 用 android layout x 和 android layout y 属性 将 两 个 Button 视图 (在 一 
& 180dpi 的 AVD 上 进行 测试 ) 定 位 在 指定 的 位 置 处 。 
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然而， 当 在 高 分 辩 率 的 屏幕 上 得 看 活动 时 ，AbsoluteLayonut 存在 一 个 问题 (如 图 3-12 所 
示 )。 因 此 ， 从 Android 1.5 以 后 ，AbsoluteLayout 己 经 被 弃 用 了 (尽管 当前 版 本 仍旧 支持 它 )。 
鉴于 不 能 保证 在 Android 的 未 来 版 本 中 是 否 文 持 此 视图 组 ， 应 该 在 用 户 界 面 中 避免 使 用 
AbsoluteLayout， 而 使 用 本 章 描述 的 其 他 布局 。 

CETT mm E 


Button Button 


3-11 图 3-12 
3.1.4 TableLayout 


TableLayout 以 行 和 列 的 形式 组 织 视 图 。 使 用 <TableRow> 元 素来 指定 表 中 的 某 一 行 。 
每 一 行 可 以 包含 一 个 或 多 个 视图 。 行 内 的 每 个 视图 构成 一 个 单元 格 。 每 一 列 的 宽度 由 此 列 
中 最 大 单元 格 的 宽度 来 决定 。 

考虑 下 列 main.xml 文件 的 内 容 : 


<TableLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout height-"fill parent" 
android:layout width-"fill parent" » 
<TableRow> 
<TextView 
android:text-"User Name:" 
android:width -"120dp" 
/> 
<EditText 
android: id="@+id/txtUserName" 
android:width="200dp" /> 
</TableRow> 
<TableRow> 
<TextView 
android: text="Password:" 


/> 
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<EditText 
android: id="@+id/txtPassword" 
android: password="true" 
/> 
</TableRow> 
<TableRow> 
<TextView /> 
<CheckBox android:id="@+id/chkRememberPassword" 
android:layout width="fill parent" 
android:layout height-"wrap content" 
android:text="Remember Password" 
/> 
</TableRow> 
<TableRow> 
<Button 
android: id="@+id/buttonSignIn"™ 
android:text="Log In" /> 
</TableRow> 
</TableLayout> 


图 3-13 展示 了 以 上 代码 在 Android 模拟 器 上 呈现 的 效果 。 

可 注意 到 ， 在 上 述 例子 中 ，TableLayout 中 有 4 行 2 列 。 直 接 位 于 Password TextView 
之 下 的 单元 格 用 <TextView/> 空 元 素 填充 。 如 果 不 这 样 做 ，Remember Password 复 选 框 将 显 
示 在 Password TextView 之 下 ， 如 图 3-14 中 所 示 。 


目 ” 3554 ndi 4.0 
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Password: r 
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" Layouts 


User Name: 
Passwora: 
Remember Password 


Log In 


图 3-13 图 3-14 


3.1.5 RelativeLayout 


RelativeLayout 可 用 于 指定 子 视 图 相对 于 彼此 之 间 是 如 何 定位 的 。 考 虑 下 列 main.xml 
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文件 的 内 容 : 


<?xml version-"1.0" encoding-"utí-8"?- 
<RelativeLayout 
android: id="@+id/RLayout" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
xmins:android="http://schemas.android.com/apk/res/android" > 


<TextView 
android: id="@+id/1b1Comments" 
android:layout width="wrap content" 
android: layout height="wrap content" 
android: text="Comments" 
android: layout alignParentTop-"true" 
android:layout alignParentLeft-"true" /> 


«EditText 
android: id="@+id/txtComments" 
android:layout width-"fill parent" 
android:layout height-"170px" 
android:textSize-"18sp" 
android:layout alignLeft="@+id/1lb1Comments" 
android:layout below="@+id/1b1Comments" 
android:layout centerHorizontal-"true" /» 


«Button 
android: id="@+id/btnSave" 
android:layout width="125px" 
android:layout height="wrap content" 
android:text="Save" 
android:layout below="@+id/txtComments" 
android:layout alignRight="@+id/txtComments"™ /> 


<Button 

android:id="@+id/btnCancel" 
android:layout width="124px" 
android:layout height="wrap content" 
android:text-"Cancel" 
android:layout below="@+id/txtComments" 
android:layout alignLeft="@+id/txtComments"™ /> 

«/RelativeLayout» 


可 注意 到 ， 每 一 个 藤 入 RelativeLayout 中 的 视图 都 有 使 它 与 其 他 视图 对 齐 的 属性 。 这 
些 属性 如 下 所 示 : 


e layout alignParentTop 
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e layout alignParentLeft 
e layout alignLeft 

e layout alignRight 

e layout below 


e layout centerHorizontal 
每 一 个 属性 的 值 是 引用 的 视图 的 ID. Bu Tf AY 
XML 用 户 界 面 创建 的 屏幕 如 图 3-15 Pron e 


3.1.6 FrameLayout 


FrameLayout 是 一 个 在 屏幕 上 可 以 用 来 显示 单 
个 视图 的 占 位 符 。 添 加 到 FrameLayout 中 的 视图 常 
利 锚 定 在 布局 的 左上 方 。 考 虑 main xml 文件 中 的 下 
列 内 容 : 

<?xml version-"1.0" encoding-"utfí-8"?» 

<RelativeLayout 

android:id="@+id/RLayout" 


android:layout width="fill parent" 
android:layout height-"fill parent" 
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xmins:android-"http://schemas.android.com/apk/res/android" > 


<TextView 
android: id="@+id/1b1Comments" 


android: layout width-"wrap content" 


android:layout height="wrap content" 


android:text="Hello, Android!" 


android: layout alignParentTop-"true" 


android:layout alignParentLeft-"true" /> 


<FrameLayout 


android: layout width-"wrap content" 


android: layout height="wrap content" 
android:layout alignLeft="@+id/1b1Comments" 
android: layout _below="@+id/l1b1Comments" 
android: layout centerHorizontal-"true" > 


<ImageView 


android:src = "@drawable/droid" 


android: layout width-"wrap content" 


android:layout height="wrap content" /> 


</FrameLayout> 
</RelativeLayout> 


这 里 , RelativeLayout 中 有 一 个 FrameLayout. 在 该 FrameLayout PikA T 


用 户 界 面 如 图 3-16 所 示 。 


-个 ImageView。 
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Hello, Android! 


图 3-16 


注意 : 这 个 例子 假设 res/drawable-mdpi 3 fF X: FA — 4.2 A droid.png 的 图 像 。 


如 条 在 FrameLayout 中 洪 加 男 一 个 视图 (如 Button 视图 )， 这 个 视图 将 履 兰 先前 的 视图 
(如 图 3-17 所 示 ): 


<?xml version-"1.0" encoding-"utfí-8"?» 


<RelativeLayout 

android: id="@+id/RLayout" 

android: layout width="fill parent" 

android: layout height-"fill parent" 

xmlns:android-"http://schemas.android.com/apk/res/android" 

> 

<TextView 
android:id="@+id/1lb1Comments" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Hello, Android!" 
android:layout alignParentTop="true" 
android:layout alignParentLeft-"true" 
/> 

<FrameLayout 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignLeft="@+id/1lb1Comments" 
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<ImageView 


android: 
android: 
android: 


<Button 


android: 
android: 


android 
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layout_below="@+id/1b1Comments" 


:layout centerHorizontal-"true" > 


src — "(idrawable/droid" 
layout width-"wrap content" 
layout height="wrap content" /> 


layout width="124dp" 
layout height="wrap content" 


:text="Print Picture" /> 


</FrameLayout> 
</RelativeLayout> 
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Hello, Android! 


图 3-17 


Android 用 PARI 


注意 : 虽然 可 以 在 FrameLayout 中 添加 多 个 视图 ， 但 每 一 个 视图 都 堆 登 在 前 一 
”个 上 面 . 这 在 想 将 一 系列 图 像 变 成 动画 , 使 得 每 次 只 有 一 个 视图 可 见 的 情况 下 


很 有 用 。 


3.1./ ScrollView 


ScrollView 是 一 种 特殊 类 型 的 FrameLayout， 因 为 它 可 以 使 用 户 滚动 显示 一 个 占据 的 衬 


由 大 于 物理 显示 的 视图 列表 。ScrollView 只 能 包 合 


LinearLayout. 


-个 子 视 图 或 视图 组 ， 通 常 是 


注意 : 不 要 将 ScrollView 和 ListView( 第 4 章 将 讨论 ) 一 起 使 用 。ListView 用 来 
显示 一 个 相关 信息 的 列表 并 针对 大 列表 的 处 理 进行 了 优化 。 
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下 而 的 main.xml 的 内 容 显 示 了 一 个 包含 LinearLayout 的 ScrollView, ifj LinearLayout 
Xf S—#£ Button 和 EditText 视图 : 


<ScrollView 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android" > 


«LinearLayout 

android:layout width-"fill parent" 

android:layout height-"wrap content" 

android:orientation-" vertical" > 

«Button 
android: id="@+id/buttonl" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Button 1" /> 

<Button 
android: id="@+id/button2" 
android: layout width-"fill parent" 
android:layout height="wrap content" 
android:text="Button 2" /> 

<Button 
android: id="@+id/button3" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Button 3" /» 

«EditText 
android:id="@t+tid/txt" 
android:layout width="fill parent" 
android: layout height-"600dp" /> 

<Button 
android: id="@+id/button4" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Button 4" /> 

<Button 
android: id="@+id/button5" 
android: layout width-"fill parent" 
android:layout height="wrap content" 
android:text="Button 5" /> 

</LinearLayout> 
«/ScrollView» 


如 果 在 Android 模拟 器 中 加 载 前 和 面 的 代码 ， 会 看 到 如 图 3-18 所 示 的 效果 。 


#38 Android 用 户 界 面 
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Bl Layouts 


图 3-18 


因为 EditText 目 动 获得 焦点 ， 所 以 它 会 填充 整个 活动 (因为 高 度 被 设 为 了 600dp)。 为 了 
防止 它 获 得 焦点 ， 在 <LinearLayout> 元 素 中 添加 下 和 而 的 两 个 属性 : 
<LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"vertical" 
android: focusable="true" 
android: focusableInTouchMode="true" > 


现在 可 以 查看 按钮 并 滚动 视图 列表 了 (如 图 3-19 所 示 )。 


3 ^ ITAA abi) E Sen drat 4.0 


" Layouts | - Layouts 
Button 1 
Button 2 


Button 3 


Button 4 


Button 5 
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有 时候 可 能 想 让 EditText 目 动 获得 焦点 ， 但 是 不 想 让 软件 输入 面板 (键盘 ) 目 动 显示 (在 
实际 设备 上 会 目 动 显示 )。 为 了 防止 键盘 显示 ， 在 AndroidManifest.xml 文件 的 <activity> 元 
素 中 添加 下 面 的 属性 : 

«activity 
android:label-"8string/app name" 
android:name=".LayoutsActivity" 
android: windowSoftInputMode="stateHidden" > 
«intent filter > 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 


3.2 META 


现代 智能 手机 的 主要 特征 之 一 是 它们 切换 屏幕 方向 的 能 力 ，Android 也 不 例外 。Android 
支持 两 种 屏幕 方向 : 纵向 和 横向 。 默 认 情 况 下 ， 当 改变 Android 设备 的 显示 方向 时 ， 当 前 
显示 的 活动 将 自动 在 新 方向 上 重 绘 其 内 容 。 这 是 因为 当 显 示 方 向 上 发 生 改 变 时 ， 都 会 触发 
活动 的 onCreate0 方 法 。 
@ 注意 : SRE Android 设备 的 方向 时 ， 当 前 活动 实际 上 是 先 被 销毁 ， 然 后 再 重 
”新 创建 。 


然而 ， 当 重 绘 时 ， 视 图 可 能 会 按照 其 原始 位 置 绘制 (这 取决 于 所 选择 的 布局 )。 图 3-20 
展示 了 之 前 提 到 的 一 个 例子 ， 分 别 以 纵向 和 横向 模式 进行 显示 。 
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在 横向 模式 下 可 以 看 到 ， 屏 幕 右 侧 有 大 量 的 空余 空间 可 以 使 用 。 而 且 ， 当 屏幕 方向 被 
设置 成 横向 时 ， 任 何 位 于 屏幕 底部 的 额外 的 视图 将 被 隐藏 。 


AR, Ay LAE AY un 


下 两 种 技术 来 处 理 屏 项 方 向 的 变化 : 


e 锁定 一 一 将 视图 锚 定 到 屏 攻 的 四 条 边 是 最 容易 的 方法 。 当 屏 姑 方 回 改变 时 ， 视 图 可 
以 整齐 地 锁定 于 屏幕 边缘 。 


e 调整 大 小 和 重新 定位 


尽管 锚 定 和 居中 显示 的 技术 简单 , 可 以 确保 视图 能 处 理 屏 


厦 方 癌变 化 ， 但 最 佳 的 技术 还 是 根据 当前 屏 钴 方 癌 重新 调整 每 一 个 视图 的 大 小 。 


3.2.1 锁定 视图 


使 用 RelativeLayout 可 以 很 容易 实现 销 定 。 考 虑 下 列 main xml 文件 ， 其 中 包含 了 嵌入 
在 <RelativeLayout> 元 素 中 的 5 个 Button 视图 : 


<RelativeLayout 


android:layout width-"fill parent" 


android:layout height-"fill parent" 


xmlns:android-"http://schemas.android.com/apk/res/android"» 


«Button 
android: 
android: 
android: 
android: 
android: 
android: 

«Button 
android: 
android: 
android: 
android: 
android: 
android: 

«Button 
android: 
android: 
android: 
android: 
android: 
android: 

«Button 
android: 
android: 
android: 
android: 
android: 
android: 

«Button 
android: 
android: 
android: 


id="@+id/button1" 

layout width="wrap content" 
layout height="wrap content" 
text="Top Left" 

layout alignParentLeft-"true" 
layout alignParentTop-"true" /> 


id="@+id/button2" 

layout width="wrap content" 
layout height-"wrap content" 
text="Top Right" 

layout alignParentTop-"true" 
layout alignParentRight-"true" /» 


id="@+id/button3" 

layout width="wrap content" 

layout height="wrap content" 
text="Bottom Left" 

layout alignParentLeft-"true" 
layout alignParentBottom-"true" /» 


id="@+id/button4" 

layout width="wrap content" 

layout height="wrap content" 
text="Bottom Right" 

layout alignParentRight-"true" 
layout alignParentBottom-"true" /» 


id="@+id/button5" 


layout width-"fill parent" 
layout height-"wrap content" 
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android:text-"Middle" 

android:layout centerVertical-"true" 

android:layout centerHorizontal-"true" /» 
</RelativeLayout> 


注意 不 同 Button 视图 中 所 具有 的 以 下 属性 : 
e layout alignParentLeft 将 视图 与 其 父 视图 的 B Layouts 


和 
上 ”5ndrotd 40 


左 侧 对 齐 Top Left Top Right 
e layout alignParentRight 一 一 将 视图 与 其 父 视 图 的 

右 侧 对 齐 
e layout alignParentTop 将 视图 与 其 父 视图 的 

上 部 对 齐 
e layout alignParentBottom 一 一 将 视图 与 其 父 视 图 Middle 

的 底部 对 齐 
e layout centerVertical 一 一 使 视图 在 其 父 视图 中 得 

直 居 中 
e layout centerHorizontal 一 一 使 视图 在 其 父 视图 中 

水 平 居中 Bottom Left Bottom Right 
图 3-21 展示 了 以 纵 同 模式 观察 到 的 活动 的 效果 。 —————————————————- 
当 屏 幕 方 同 改 变 为 横向 模式 时 ，4 个 按钮 对 齐 到 屏 图 3-21 

熏 的 四 边 。 中 间 的 按钮 在 屏幕 中 央 显 示 ， 宽 度 完 全 拉 伸 到 整个 屏幕 (如 图 3-22 所 示 )。 
E S554 Androxd AO == | 


Top Right 


Bottom Left Bottom Right 


GO O O e 
O Wey © 
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3.2.2 ”调整 大 小 和 重新 定位 


除了 将 视图 锚 定 到 屏幕 的 四 边 之 外 ， 基 于 屏幕 方 回 定制 
用 户 界 面 的 更 简单 的 方法 是 为 每 个 方向 上 的 用 户 界 面 创建 一 
个 包含 XML 文件 的 单独 的 res/layout KR. H T frt 
模式 ， 可 以 在 res 文件 夹 下 创建 一 个 新 文件 夹 ， 并 命名 为 
layout-land( zr Es m). [KK 3-23 显示 了 这 样 的 含有 main.xml 
文件 的 新 文件 夹 。 

基本 上 , 包含 在 layout 文件 夹 下 的 main.xml 文件 为 活动 
定义 了 纵 回 模式 的 用 户 界 面 ， 而 在 layout-land LAFE FHI 
main.xml 文件 定义 了 横向 模式 的 用 户 界 面 。 

layout 文件 夹 下 的 main.xml 文件 的 内 容 如 下 所 示 : 

<?xml version-"1.0" encoding="utf-8"?> 

<RelativeLayout 


android:layout width-"fill parent" 
android:layout height-"fill parent" 


#38 Android FHP 5E BI 


"| Es Layouts 


p (gH sre 


p od gen [Generated Java Files] 


> BA Android 4.0 


> EE drawable-hdpi 
> (EE drawable-Idpi 
>  drawable-mdpi 
4 (= layout 

|X| main.xml 
4 (= layout-land 

![X| mmainxmnl 
D 6 values 


al AndroidManifest.xml 


[=| proguard.cfg 
project.properties 


3-21 


xmlns:android-"http://schemas.android.com/apk/res/android"» 


«Button 
android: id="@+id/buttonl" 
android: layout width-"wrap content" 
android: layout height="wrap content" 
android:text="Top Left" 
android: layout alignParentLeft-"true" 
android:layout alignParentTop-"true" /> 
«Button 
android: id="@+id/button2" 
android: layout width-"wrap content" 
android: layout height="wrap content" 
android:text="Top Right" 


android: 
android: 
<Button 
android: 
android: 
android: 
android: 
android: 
android: 
«Button 
android: 
android: 
android: 
android: 
android: 
android: 
«Button 


layout alignParentTop-"true" 
layout alignParentRight-"true" /» 


id="@+id/button3" 

layout width="wrap content" 

layout height="wrap content" 
text="Bottom Left" 

layout alignParentLeft="true" 
layout alignParentBottom="true" /> 


id="@+id/button4" 

layout width="wrap content" 

layout height="wrap content" 
text-"Bottom Right" 

layout alignParentRight-"true" 
layout alignParentBottom-"true" /> 
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android: id="@+id/button5" 

android: layout width-"fill parent" 

android: layout height="wrap content" 

android: text="Middle" 

android: layout centerVertical-"true" 

android: layout centerHorizontal-"true" /> 
</RelativeLayout> 


下 面 显示 了 layout-land 文件 夹 下 的 main.xml 文件 的 内 容 ( 粗 体 显 示 的 语句 是 横向 模式 


<?xml version-"1.0" encoding-"utf-8"?» 
«RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
xmlns:android-"http://schemas.android.com/apk/res/android"» 
«Button 
android:id-"(wid/buttonl" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Top Left" 
android:layout alignParentLeft-"true" 
android:layout alignParentTop-"true" /» 
«Button 
android:id-"(vid/button2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Top Right" 
android:layout alignParentTop-"true" 
android:layout alignParentRight-"true" /> 
«Button 
android: id="@+id/button3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Left" 
android:layout alignParentLeft-"true" 
android:layout alignParentBottom-"true" /» 
«Button 
android: id="@+id/button4" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Bottom Right" 
android:layout alignParentRight-"true" 
android:layout alignParentBottom-"true" /» 
«Button 
android:id-"G8-cid/button5" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Middle" 
android:layout centerVertical-"true" 
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android:layout centerHorizontal-"true" /> 
«Button 
android: id="@+id/button6" 
android: layout width="180px" 
android:layout height="wrap content" 
android: text="Top Middle" 
android: layout centerVertical-"true" 
android: layout centerHorizontal="true" 
android: layout alignParentTop="true" /> 
<Button 
android: id="@+id/button7" 
android: layout width="180px" 
android:layout height="wrap content" 
android: text="Bottom Middle" 
android:layout centerVertical-"true" 
android:layout centerHorizontal="true" 
android:layout alignParentBottom="true" /? 
</RelativeLayout> 


当 活动 以 纵向 模式 加 载 时 ， 将 显示 5 个 按钮 ， 如 图 3-24 所 示 。 


F 
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Middle 
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图 3-24 图 3-25 
当 活 动 以 横 癌 模式 加 载 时 ， 将 出 现 7 个 按钮 (如 图 3-25 所 示 )， 这 证 明 当 设备 处 于 不 同 
方向 时 ， 将 加 载 不 同 的 XML 文件 。 
使 用 这 种 方法 ， 当 设备 方向 改变 时 ，Android 将 根据 当前 屏幕 方向 为 活动 自动 加 载 相 
应 的 XML 文件 。 
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3.3 ”省 理 屏 幕 方 同 的 变化 


既然 已 经 了 解 了 如 何 实现 两 种 技术 以 便 适 应 屏 界 方向 的 变化 ， 那 么 让 我 们 探究 一 下 当 
设备 改变 方 同 时 活动 的 状态 会 发 生 什么 情况 。 
下 和 面 的 “ 试 一 试 ” 展 示 了 当 设 备 改变 方 同 时 活动 的 行为 。 


了 解 方向 改变 时 活动 的 行为 


Orientations.zip VCZ X PFRI LAGE Wrox.com E Fi 


(1) 使 用 Eclipse， 创 建 一 个 名 为 Orientations 的 新 项 目 。 
(2) 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«EditText 
android: id="@+id/txtFieldi" 
android: layout width="fill parent" 
android: layout height-"wrap content" /? 


«EditText 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
</LinearLayout> 


(3) 在 OrientationsActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Orientations; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 


public class OrientationsActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
Log.d("StateInfo", "onCreate"); 


@Override 
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public void onStart() { 
Log.d("StateInfo", "onStart") ; 
super.onStart(); 


@Override 

public void onResume() { 
Log.d("StateInfo", "onResume") ; 
super .onResume () ; 


@Override 
public void onPause() { 
Log.d("StateInfo", "onPause") ; 


super .onPause(); 


@Override 

public void onStop() { 
Log.d("StateInfo", "onStop") ; 
super.onStop(); 


@Override 

public void onDestroy() { 
Log.d("StateInfo", "onDestroy") ; 
super.onDestroy () ; 


@Override 

public void onRestart() { 
Log.d("StateInfo", "onRestart"); 
super.onRestart(); This is a line in the first EditText 


p Orientations 


} This is another line in the second 


EditText 

(4) HE F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 

(5) 在 两 个 EditText 视图 中 输入 一 些 文本 (如 图 3-26 
所 示 )。 

(6) 按 Ctrl+F11 组 合 键 改变 Android 模拟 器 的 显示 方 

[n]. Bd 3-27 显示 了 横 回 模式 下 的 模拟 器 效果 。 注 意 ,第 l 

个 EditText 视图 中 的 文本 仍旧 可 见 ， 而 第 2 EditText 视 


图 3-26 
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" Orientations 


This is a line in the first EditText 


图 3-27 


(7) 观察 LogCat 窗口 中 的 输出 (需要 在 Eclipse 中 切换 到 Debug 透视 图 ), 应 该 看 到 类 似 
如 下 所 示 内 容 : 


12-15 12:27:20.747: D/StateInfo(557): onCreate 
12-15 12:27:20.747: D/StateInfo(557): onStart 
12-15 12:27:20.747: D/StateInfo(557): onResume 


12-15 12:39:37.846: D/StatelInfo(557): onPause 
12-15 12:39:37.846: D/StateInfo(557): onStop 
12-15 12:39:37.866: D/StatelInfo(557): onDestroy 
12-15 12:39:38.206: D/StateInfo(557): onCreate 
12-15 12:39:38.216: D/StateInfo(557): onStart 
12-15 12:39:38.257: D/StateInfo(557): onResume 


示例 说 明 
从 LogCat 窗口 中 的 输出 内 容 可 以 明显 看 出 ， 当 设备 改变 方 同 时 ， 活 动 先 被 销毁 : 


12-15 12:39:37.846: D/StateInfo(557): onPause 
12-15 12:39:37.846: D/StateInfo(557): onStop 
12-15 12:39:37.866: D/StateInfo(557): onDestroy 


然后 ， 它 被 重建 : 


12-15 12:39:38.206: D/StateInfo(557): onCreate 
12-15 12:39:38.216: D/StateInfo(557): onStart 
12-15 12:39:38.257: D/StateInfo(557): onResume 


丁 解 这 一 行为 是 重要 的 ， 因 为 需要 确保 米 取 必 要 的 措施 来 你 持 方 同 改变 之 前 活动 的 状 
态 。 例 如 ， 在 活动 中 可 能 包含 一 些 计算 所 需 的 值 的 变量 。 对 于 任意 活动 ， 应 该 在 onPause() 
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事件 中 保存 任何 您 需要 保存 的 状态 ， 这 一 事件 在 每 次 活动 改变 方向 时 触发 。 下 一 节 讲 述 保 
存 状态 信息 的 不 同方 法 。 

另 一 个 再 要 理解 的 重要 行为 是 当 包含 视图 的 活动 被 销毁 时 ， 只 有 那些 在 这 个 活动 中 被 
命名 的 视图 (通过 android:id 属性 ) 才 能 保持 它们 的 状态 。 例 如 ， 在 向 EditText 视图 中 输入 一 
些 文 本 的 同时 ， 用 户 可 能 会 改变 显示 方向 。 出 现 这 种 情况 时 ，EditText 视图 中 的 任何 文本 
将 被 保持 并 在 活动 重新 创建 时 上 自动 恢复 。 相 反 ， 如 果 没 有 使 用 android:id 属性 命名 EditText 
视图 ， 活 动 将 无 法 保持 视图 中 当前 所 含 文本 。 


3.3.1 配置 改变 时 保持 状态 信 


到 目前 为 止 ， 您 已 经 学 习 了 屏幕 方向 改变 时 会 销毁 和 重建 一 个 活动 。 记 住 ， 当 重建 一 
个 活动 时 ， 活 动 的 当前 状态 可 能 会 丢失 。 当 终止 一 个 活动 时 ， 将 触发 以 下 两 个 方法 中 的 一 
个 或 两 个 : 

e onPause(0 一 一 当 一 个 活动 被 终止 或 转 入 后 台 时 都 会 触发 这 一 方法 。 

e onSaveInstanceState(0 一 一 当 一 个 活动 将 要 被 终止 或 转 入 后 台 时 , 也 会 触发 这 一 方法 

(正如 onPause0 方 法 一 样 )。 然 而 ， 与 onPause0 方 法 不 同 的 是 ， 当 一 个 活动 从 栈 中 和 缉 
载 时 (例如 用 户 按 下 了 Back 按钮 ) 不 会 触发 onSaveInstanceState0 方 法 ， 这 是 因为 后 
面 无 须 恢复 其 状态 。 

简 而 言 之 ， 要 保持 一 个 活动 的 状态 ， 可 以 实现 onPause0 方 法 ,然后 使 用 自己 的 方法 来 
保存 活动 状态 ， 如 利用 数据 库 、 内 部 或 外 部 的 文件 存储 堪 等 。 

如 条 只 是 想 保存 活动 状态 用 来 在 以 后 活动 重建 时 (例如 当 设 备 改变 方 和 同时) 进行 恢复 ， 
那么 更 简单 的 方法 是 实现 onSaveInstanceState0 方 法 。 这 个 方法 提供 了 Bundle 对 象 作 为 一 
个 参数 ， 可 以 用 它 保存 活动 的 状态 。 以 下 代码 展示 了 在 onSavelnstanceState 方法 中 可 以 将 
字符 串 ID 保存 到 Bundle 对 象 中 : 

@Override 

public void onSavelInstanceState (Bundle outState) { 
//---save whatever you need to persist--- 
outState.putString("ID", "1234567890"); 


super.onSaveInstanceState(outState); 


} 


当 重 建 一 个 活动 时 ， 首 先 触 发 onCreate0 事 件 ， 随 后 是 onRestoreImstanceState0 方 法 。 此 事 
件 可 以 使 您 检索 先前 在 onSavelnstanceState 方法 中 通过 其 参数 Bundle 对 象 保存 的 状态 : 
@Override 
public void onRestorelInstanceState (Bundle savedInstanceState) | 
super .onRestorelInstanceState (savedInstanceState) ; 
//---retrieve the information persisted earlier--- 
String ID = savedInstanceState.getString("ID"); 
} 


尽管 可 以 使 用 onSaveInstanceState0 方 法 来 保存 状态 信息 ， 但 要 注意 只 能 通过 一 个 
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Bundle 对 象 保存 状态 信息 的 局 限 性 。 如 果 需 要 保存 更 复杂 的 数据 结构 ， 这 就 不 是 一 个 合适 
的 解决 方法 。 
男 一 个 可 以 使 用 的 方法 是 onRetainNonConfigurationInstance(0) 方 法 。 当 一 个 活动 由 于 配 
时 改变 (例如 屏 蕉 方 癌 的 变化 、 键 租 是 否 可 用 等 ) 将 要 被 销毁 时 会 触发 这 一 方法 。 可 以 通过 
在 该 方法 中 返回 来 保存 当前 的 数据 ， 如 下 所 示 : 
QOverride 
public Object onRetainNonConfigurationInstance() { 


//---save whatever you want here; it takes in an Object type--- 
return("Some text to preserve"); 


HE. 当 屏 幕 方向 改变 时 , 这 一 变化 是 所 请 配置 改变 的 一 部 分 。 配置 改变 将 销 
^ See a SATE. 


注意 ， 此 方法 返回 一 个 Object 类 型 ， 它 几乎 允许 返回 任何 数据 类 型 。 要 提取 保存 
的 数据 ， 可 以 使 用 getLastNonConfigurationInstance( 77 iX: f£ onCreateO) 方 法 中 进行 提取 ， 
如 下 所 示 : 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView(R.layout.main); 
Log.d("StateInfo", "onCreate"); 
String str = (String) getLastNonConfigurationInstance (); 
} 


当 再 要 临时 保存 一 些 数据 , 例如 从 Web 服务 中 下 载 了 数据 , 而 用 户 改 变 了 屏幕 方向 时 ， 
十 分 适合 onRetainNonConfigurationInstanceO0 和 getLastNonConfigurationImnstance0) 方 法 。 在 
这 种 情况 中 ， 使 用 这 两 种 方法 保存 数据 要 比 再 次 下 载 数据 高 效 得 多 。 
3.3.2 ”检测 方向 改变 


有 时 需要 在 运行 时 知道 设备 的 当前 方 同 。 要 确定 这 一 点 , 可 以 使 用 WindowManger 25. 
以 下 代码 片段 演示 了 如 何以 编程 方式 来 检测 活动 的 当前 方 同 : 


import android.view.Display; 
import android.view.WindowManager ; 


@Override 

public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


//---get the current display info--- 
WindowManager wm = getWindowManager () ; 
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Display d = wm.getDefaultDisplay(); 
if (d.getWidth() > d.getHeight()) { 


//---landscape mode--- 
Log.d("Orientation", "Landscape mode"); 


} 
else { 
//---portrait mode--- 
Log.d("Orientation", "Portrait mode"); 
} 


} 


getDefaultDisplay0 方 法 返回 一 个 表示 设备 屏幕 的 Display 对 象 。 然 后 ， 您 可 以 获得 其 
宽度 和 高 度 ， 进 而 推 新 出 当前 的 屏幕 方向 。 


3.3.3 ”控制 活动 的 方 回 


有 时 ， 您 也 许 想 要 保证 应 用 程序 只 在 一 个 特定 的 方向 上 显示 。 例 如 ， 您 可 能 正在 编写 
-个 只 能 以 横向 模式 呈现 的 游戏 。 在 这 种 情况 下 ， 可 以 使 用 Activity 类 的 
setRequestOrientation0 方 法 以 编程 方式 强制 改变 显示 方 问 : 
import android.content.pm.ActivityInfo; 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


//---change to landscape mode--- 


setRequestedOrientation(ActivityInfo.SCREEN ORIENTATION LANDSC 
APE); 
} 


要 改 为 纵向 模式 ， 可 使 用 ActivityInfo.SCREEN ORIENTATION PORTRAIT 常量 。 
除了 使 用 setRequestOrientation0 方 法 ， 还 可 以 在 AndroidManifest.xml 文件 中 的 
<activity> 元 素 上 使 用 android:screenOrientation 属性 ， 来 将 活动 限制 在 一 个 特定 方 问 上， 如 
下 所 示 : 
<?xml version-"1.0" encoding-"utfí-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Orientations" 
android:versionCode-"]" 
android:versionName-"].0" > 


«uses-sdk android:minSdkVersion="14" /> 
«application 


android:icon-"(idrawable/ic launcher" 
android: label="@string/app name" > 
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<activity 
android: label="@string/app name" 
android:name-".OrientationsActivity" 
android:screenOrientation-"landscape" > 
«intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category. 
LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 


上 述 的 例子 将 活动 限制 在 一 个 特定 的 方向 上 (此 处 是 横 癌 )， 并 且 防 止 活动 被 销毁 。 也 
就 是 说 ， 当 设备 方 加 改变 时 ， 活 动 不 会 被 销毁 并 且 也 不 会 再 次 触发 onCreate(0 方 法 。 

以 下 是 在 android:screenOrientation 属性 中 可 以 指定 的 两 个 值 : 

e portrait 一 一 纵向 模式 

e ”sensor 一 一 其 于 加 速 计 (默认 ) 


3.4 使 用 Action Bar 


Uk SAR, Android 3 和 Android 4 中 引入 的 另 一 个 新 功能 是 Action Bar. Action Bar fX 
谷 了 传统 的 位 于 设备 屏幕 顶部 的 标题 栏 ,和 它 显示 应 用 程序 的 图 标 和 活动 的 名 称 。Action Bar 
的 右 侧 还 可 以 有 可 选 的 动作 项 。 图 3-28 显示 了 内 置 的 Email 应 用 程序 在 Action Bar 中 显示 
了 应 用 程序 岁 标 、 活 动 名 称 和 一 些 动作 项 。 下 一 节 将 详细 讨论 工作 项 。 
fa 5554:Android 4.0 | = | = || 
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下 面 的 “ 试 一 试 ” 显 示 了 如 何以 编程 方式 隐 臧 或 显示 Action Bar. 


显示 和 隐藏 Action Bar 

(1) 使 用 Eclipse 创建 一 个 新 的 Android 项 目 ， 命 名 为 MyActionBar. 

(2) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 应 该 会 看 到 应 用 程序 及 位 于 其 屏幕 
顶部 的 Action Bar( 包 含 应 用 程序 图 标 和 应 用 程序 的 名 称 MyActionBar， 如 图 3-29 所 示 )。 


» 
8^ 5554 Àndroid AU 


p MyActionBar 


Hello World, MyActionBarActivity! 


图 3-29 


(3) 为 了 隐藏 Action Bar, {E AndroidManifest.xml 文件 中 添加 下 面 的 粗 体 显示 的 代码 : 


<?xml version-"1.0" encoding-"utí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.MyActionBar" 
android:versionCode-"]" 
android:versionName-"].0" > 


«uses-sdk android:minSdkVersion="14" /> 


«application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
«activity 
android:label="@string/app name" 
android:name-".MyActionBarActivity" 
android: theme="@android:style/Theme.Holo.NoActionBar" > 
<intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 


(4) 在 Eclipse 中 选择 项 目 名 称 ， 然 后 rosea 
按 F11 键 在 Android 模拟 器 上 再 次 调试 应 
用 程序 o dX dX Action Bar 不 会 显示 ， Hello World, MyActionBarActivity! 
如 图 3-30 所 示 。 
(5) 也 可 以 以 编程 方式 使 用 ActionBar 类 图 3-30 
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移 除 Action Bar。 为 此 ， 首 先 需要 删除 前 面 的 步骤 中 添加 的 android:theme 属性 。 这 一 点 很 
重要 ， 否 则 下 一 步 将 导致 应 用 程序 引发 一 个 异 和 。 
(6) 按照 如 下 代码 修改 MyActionBarActivity java 文件 : 


package net.learn2develop.MyActionBar; 


import android.app.ActionBar; 
import android.app.Activity; 
import android.os.Bundle; 


public class MyActionBarActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 

super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


ActionBar actionBar = getActionBar(); 
actionBar.hide(); 
//actionBar.show(); //---show it again--- 


) 
(7) 按 Fll 键 在 模拟 器 上 再 次 调试 应 用 程序 。Action Bar 将 被 隐藏 。 


示例 说 明 

使 用 android:theme 属性 可 以 关闭 活动 对 Action Bar 的 显示 。 将 这 个 属性 设 为 
@android:style/Theme.Holo.NoActionBar 22 paji Action Bar。 或 者 ， 也 可 以 通过 编程 方式 ， 在 
运行 时 使 用 getActionBar0 方 法 获得 对 Action Bar 的 引用 。 调 用 hide0 方 法 会 隐藏 Action Bar, 
调用 show0 方 法 则 会 显示 它 。 

注意 , 如果 使 用 android:theme 属性 来 关闭 Action Bar, 在 运行 时 调用 getActionBar0 方 法 
会 返回 null。 因 此 ， 使 用 ActionBar 类 以 编程 方式 打开 /关闭 Action Bar 总 是 更 好 的 方法 。 


3.4.1 向 Action Bar 添加 动作 项 


除了 在 Action Bar 的 左 侧 显 示 应 用 程序 图 标 和 活动 名 称 以 外 ， 还 可 以 在 Action Bar 上 
显示 其 他 项 ， 这 些 项 叫做 动作 项 。 动 作 项 是 应 用 程序 中 经 常 执 行 的 一 些 操 作 的 快捷 方式 。 
例如 , 您 可 能 正在 构建 一 个 RSS 阅读 器 应 用 程序 , 此 时 Refresh feed, Delete feed 和 Add new 
feed 就 可 以 作为 动作 项 。 

下 和 面 的 “ 试 一 试 ” 演 示 了 如 何 辣 Action Bar 添加 动作 项 。 


添加 动作 项 


a) 使 用 前 一 节 创 建 的 同一 个 MyActionBar 项 目 ， 在 MyActionBarActivity.java 文件 中 
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添加 下 面 的 粗 体 显示 的 代码 : 


package net.learn2develop.MyActionBar; 


import android.app.Activity; 
import android.os.Bundle; 
import android.view.Menu; 
import android.view.MenuItem; 
import android.widget.Toast; 


public class MyActionBarActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


//ActionBar actionBar = getActionBar () ; 
//actionBar.hide(); 


//actionBar.show(); //---show it again--- 


@Override 

public boolean onCreateOptionsMenu (Menu menu) { 
super. onCreateOptionsMenu (menu); 
CreateMenu (menu) ; 
return true; 


@Override 
public boolean onOptionsItemSelected (MenuItem item) 
{ 

return MenuChoice (item) ; 


private void CreateMenu (Menu menu) 
{ 
Menultem mnul = menu.add(0, 0, 0, "Item 1"); 
{ 
mnul.setIcon(R.drawable.ic launcher); 
mnul.setShowAsAction(MenuItem.SHOW AS ACTION IF ROOM); 
} 
MenuItem mnu2 = menu.add(0, 1, 1, "Item 2"); 
{ 
mnu2.setIcon(R.drawable.ic launcher); 
mnu2.setShowAsAction(MenuItem.SHOW AS ACTION IF ROOM); 
} 
MenuItem mnu3 = menu.add(0, 2, 2, "Item 3"); 
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{ 
mnu3.setIcon(R.drawable.ic launcher); 
mnu3.setShowAsAction(MenuItem.SHOW AS ACTION IF ROOM); 
} 
Menultem mnu4 = menu.add(0, 3, 3, "Item 4"); 
{ 
mnud.setShowAsAction(MenuItem.SHOW AS ACTION IF ROOM); 
} 
MenuItem mnu5 = menu.add(0, 4, 4, "Item 5"); 
{ 
mnu5.setShowAsAction(MenuItem.SHOW AS ACTION IF ROOM); 
} 


private boolean MenuChoice (MenuItem item) 


i 
switch (item.getItemId()) { 
case 0: 
Toast.makeText (this, "You clicked on Item 1", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 1: 
Toast.makeText(this, "You clicked on Item 2", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 2: 
Toast.makeText(this, "You clicked on Item 3", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 3: 
Toast.makeText(this, "You clicked on Item 4", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 4: 
Toast.makeText(this, "You clicked on Item 5", 
Toast.LENGTH LONG) .show() ; 
return true; 
} 
return false; 
} 


(2) JE F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 观 察 Action Bar 右 侧 的 图 标 ( 如 图 3-31 
所 示 )。 如 果 在 模拟 器 中 单 击 MENU 按钮 ， 会 看 到 其 余 的 荣 单 项 ， 如 图 3-32 所 示 。 这 叫做 
Yat. tH 32 E (overflow menu). ÆRA MENU 按钮 的 设备 上 ， 湾 出 菜单 由 一 个 融和 箭头 的 岁 标 表 
示 。 图 3-33 显示 了 运行 在 Asus Eee Pad Transformer(Android 3.2.1) 上 的 相同 应 用 程序 。 单 
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(3) 单 击 每 个 菜单 项 会 使 Toast 类 显示 所 选 菜单 项 的 名 称 ， 如 图 3-34 所 示 。 


IMANA 4.0 


En 


le MyActionBar 


Hello World, MyActionBarActivity! 


图 3-31 


B Märdi 40 


È 4:49 


BB MyActionBar 


Hello World, MyActionBarActivity! 


图 3-32 


(4) 按 Contro F11 组 合 键 将 模拟 器 的 显示 方 癌 改 为 模 问 。 现 在 在 Action Bar 上 可 以 看 


到 4 个 动作 项 ，3 个 带 图 标 ， 


个 融 文 本 ， 如 图 3-35 所 示 。 


8^ knd 4 


p MyActionBar 


Hello World, MyActionBarActivity! 


You clicked on Item 2 
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国 | 5554:Android_4.0 
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图 3-35 


示例 说 明 
通过 调用 活动 的 onCreateOptionsMenu0 方 法 ， 为 Action Bar 添加 动作 项 : 


QOverride 

public boolean onCreateOptionsMenu(Menu menu) { 
super.onCreateOptionsMenu (menu); 
CreateMenu (menu); 
return true; 


} 
在 前 面 的 示例 中 ， 调 用 了 CreateMenu( 方 法 来 显示 一 个 菜单 项 列表 : 


private void CreateMenu (Menu menu) 
{ 
MenuItem mnul = menu.add(0, 0, 0, "Item 1"); 
{ 
mnul.setIcon(R.drawable.ic launcher); 
mnul.setShowAsAction(MenuItem.SHOW AS ACTION IF ROOM); 
} 


Menultem mnu2 = menu.add(0, 1, 1, "Item 2"); 


Í 


mnu2.seticon(R.drawable.ic launcher); 
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mnu2. 
} 
Menultem 
{ 

mnu3 

mnu3. 
} 
Menultem 
{ 

mnu4. 
} 
Menultem 
{ 

mnud. 
} 


} 
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setShowAsAction (MenuItem.SHOW AS ACTION IF ROOM); 


mnu3 = menu.add(0, 2, 2, "Item 3"); 


.SetIcon(R.drawable.ic launcher); 


setShowAsAction(Menultem.SHOW AS ACTION IF ROOM); 
mnu4 = menu.add(0, 3, 3, "Item 4"); 
setShowAsAction (MenuItem.SHOW AS ACTION IF ROOM); 
mnuS = menu.add(0, 4, 4, “Item 5"); 


setShowAsAction (MenuItem.SHOW AS ACTION IF ROOM); 


为 了 使 菜单 项 显示 为 动作 项 ， 使 用 SHOW_AS ACTION IF ROOM 常量 调用 其 setShowAsAction() 
方法 。 这 告知 Android 设备 如 果 Action Bar 上 有 空间 ， 将 该 菜单 项 显示 为 一 个 动作 项 。 
当 用 户 选 择 一 个 菜单 项 时 ，onOptionsItemSelected0O) 方 法 将 被 调用 : 


@Override 


public boolean onOptionsItemSelected (Menultem item) 


{ 


return MenuChoice (item); 


} 


这 里 调用 了 目 定 义 的 MenuChoiceQ) 772 RA A Te FORUMS, MAJ ARTE: 


private boolean MenuChoice (MenuItem item) 


{ 


switch (item.getItemId()) { 


case 0: 


Toast.makeText(this, "You clicked on Item 1", 
Toast.LENGTH LONG).show(); 
return true; 


case 1l: 


Toast.makeText(this, "You clicked on Item 2", 
Toast.LENGTH LONG).show(); 
return true; 


case 2: 


Toast.makeText(this, "You clicked on Item 3", 
Toast.LENGTH LONG).show(); 
return true; 


case 3: 


Toast. 


.makeText(this, "You clicked on Item 4", 


Toast.LENGTH LONG).show(); 
return true; 


Case 4: 


Toast. 


makeText(this, "You clicked on Item 5", 
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Toast.LENGTH LONG) .show(); 
return true; 
} 
return false; 


3.4.2 ”定制 动作 项 和 应 用 程序 图 标 


在 前 面 的 示例 中 ， 显 示 的 菜单 项 没有 文本 。 如 果 想 要 为 动作 项 同时 显示 图 标 和 文本 ， 
可 以 使 用 “|” 操 作 符 和 Menultem.SHOW AS ACTION WITH TEXT 常量 : 


Menultem mnul = menu.add(0, 0, 0, "Item 1"); 


{ 
mnul.setIcon(R.drawable.ic launcher); 
mnul.setShowAsAction( 
MenuItem.SHOW AS ACTION IF ROOM | 
MenuItem.SHOW AS ACTION WITH TEXT); 
} 
ORE, ler WF SEAN LE SCAR, n] 3-36 所 示 。 


[i 5554 Android 40 EX 


e MyActionBar 


Hello World, MyActionBarActivity! 


图 3-36 


除了 单 击 动作 项 ， 用 户 还 可 以 单 击 Actio Bar 中 的 应 用 程序 图 标 。 此 时 ，onOptionsItem- 
Selected0 方 法 将 被 调用 。 为 了 确定 被 调用 的 应 用 程序 图 标 ， 比 较 该 项 的 ID 和 android.R.id. 


home ^j tg : 


private boolean MenuChoice (MenuItem item) 


{ 
switch (item.getItemId()) { 
case android.R.id.home: 
Toast.makeText(this, 
"You clicked on the Application icon", 
Toast.LENGTH LONG).show(); 
return true; 
case 0: 
Toast.makeText(this, "You clicked on Item 1", 
Toast.LENGTH LONG).show(); 
return true; 
case 1l: 
P ees 
] 
return false; 
] 
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为 使 应 用 程序 图 标 可 被 单 击 ， 需 要 调用 setDisplayHomeAsUpEnabled0 方 法 : 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


ActionBar actionBar=getActionBar () : 
actionBar.setDisplayHomeAsUpEna 
bled (true) ; 

/factionBar.hide(); 


//actionBar.show(); //---show it CBB MyActionBar 
aga LI-—— Hello World, MyActionBarActivity 
} 
图 3-37 显示 了 在 应 用 程序 图 标的 旁边 出 现 了 一 个 第 


SK TR. 

应 用 程序 图 标 经 常 被 应 用 程序 用 来 返回 到 其 主 活动 
中 。 例 如 ， 应 用 程序 中 可 能 包含 几 个 活动 ， 此 时 可 以 使 用 
应 用 程序 图 标 作 为 一 种 快捷 方式 ， 让 用 户 可 以 直接 返回 到 
应 用 程序 的 主 活 动 中 。 为 此 ， 创 建 一 个 Intent 对 象 并 使 用 DEREN ES 
Intent FLAG ACTIVITY CLEAR TOP 标签 设置 它 总 是 


case android.R.id.home: 


图 3-37 


Toast.makeText (this, 
"You clicked on the Application icon", 
Toast.LENGTH LONG).show(); 


Intent i = new Intent(this, MyActionBarActivity.class); 
i.addFlags(Intent.FLAG ACTIVITY CLEAR TOP); 
startActivity (1); 


return true; 


Intent FLAG ACTIVITY CLEAR TOP 标签 确保 了 当 用 户 单 击 Action Bar 中 的 应 用 程 
序 图 标 时 ，back stack 中 的 一 系列 活动 被 清除 。 这 样 ， 如 果 用 户 单 击 Back 按钮 ， 应 用 程序 
中 的 其 他 活动 就 不 会 再 次 显示 。 


3.5 ”以 编程 方式 创建 用 户 界 面 


到 目前 为 止 ， 您 在 本 章 中 所 看 到 的 所 有 用 户 界面 都 是 使 用 XML 创建 的 。 如 前 所 述 ， 
祭 了 使 用 XML, 还 可 以 使 用 代码 创建 用 户 界面 。 如 果 用 户 界面 需要 在 运行 时 动态 生成 ， 这 
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个 方法 就 很 有 用 。 例 如 ， 设 想 您 正在 构建 一 个 电影 时 预订 系统 ， 您 的 应 用 程序 将 使 用 按钮 


显示 每 场 电影 的 座位 。 这 种 情况 下 ， 就 需要 根据 用 户 选择 的 电影 来 动态 生成 用 户 界 面 。 
下 面 的 “ 试 一 试 ” 泪 示 了 在 活动 中 动态 构建 用 户 界 面 所 需 的 代码 。 


tit ME 通过 代码 创建 用 户 界面 
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(1) 使 用 Eclipse， 创 建 一 个 名 为 UICode 的 新 Android 项 目 。 
(2) 在 UICodeActivityjava 文件 中 ， 添 加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.UICode; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.ViewGroup.LayoutParams; 
import android.widget.Button; 

import android.widget.LinearLayout; 

import android.widget.TextView; 


public class UlCodeActivity extends Activity [| 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
//setContentView (R.layout.main); 
//---param for views--- 
LayoutParams params = 
new LinearLayout.LayoutParams( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT); 


//---create a layout--- 
LinearLayout layout = new LinearLayout(this); 
layout.setOrientation (LinearLayout. VERTICAL) ; 


//---create a textview--- 
TextView tv = new TextView(this); 
tv.setText("This is a TextView"); 
tv.setLayoutParams (params); 


//---create a button--- 

Button btn = new Button (this); 
btn.setText ("This is a Button"); 
btn.setLayoutParams (params) ; 


//---adds the textview--- 
layout.addView (tv); 
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//---adds the button--- 
layout.addView (btn) ; 


//---create a layout param for the layout--- 
LinearLayout.LayoutParams layoutParam = 
new LinearLayout. LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams .WRAP CONTENT ) ; 


this.addContentView(layout, layoutParam) ; 
} 
(3) f£ F11 键 在 Android 230 28 EVA FE. Al 3-38 显示 活动 被 创建 了 。 


Bl Uicode 
This i5 a TextViuw 


This is a Button 


图 3-38 
示例 说 明 
本 例 中 ， 首 先 注释 掉 setContentViewO 语 句 ， 这 样 就 不 从 main .xml 文件 加 载 用 户 界 面 。 
然后 ， 创 建 一 个 LayoutParams 对 象 来 指定 可 以 被 别 的 视图 ( 接 下 来 将 创建 ) 使 用 的 布局 


//---param for views--- 
LayoutParams params = 
new LinearLayout.LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT) ; 


还 创建 一 个 LinearLayout 对 象 来 包含 活动 中 所 有 的 视图 : 


/1--—- create d layout——— 
LinearLayout layout = new LinearLayout(this); 
layout.setOrientation(LinearLayout.VERTICAL); 


下 一 步 ， 创 建 一 个 TextView 视图 -个 Button 视图 : 
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//---create a textview--- 
TextView tv = new TextView(this); 
tv.setText("This is a TextView"); 
tv.setLayoutParams (params); 


//---create a button--- 

Button btn - new Button(this); 
btn.setText("This is a Button"); 
btn.setLayoutParams (params); 


然后 将 它们 添加 a 到 LinearLayout 对 象 中 : 
//---adds the textview--- 


layout.addView (tv); 


//---adds the button--- 
layout.addView (btn); 


另外 ， 创 建 一 个 被 LinearLayout 对 象 使 用 的 LayoutParams 对 和 象 : 


//---create a layout param for the layout--- 
LinearLayout.LayoutParams layoutParam = 
new LinearLayout.LayoutParams( 
LayoutParams.FILL PARENT, 
LayoutParams.WRAP CONTENT ); 


最 后 ， 将 LinearLayout 对 象 添加 到 活动 中 : 
this.addContentView (layout, layoutParam) ; 
我 们 可 以 看 出 ， 使 用 代码 创建 用 户 界面 是 一 个 非常 费力 的 工作 。 因 此 ， 只 有 在 必要 时 
才 使 用 代码 来 动态 生成 用 户 界 面 。 


3.6 [pr FB PIOS XI 


用 户 和 用 户 界 面 在 两 个 层面 上 进行 交互 : 活动 层面 和 视图 层面 。 在 活动 层面 ，Activity 
类 暴露 了 可 以 被 重 写 的 方法 。 一 些 常见 的 可 以 在 活动 中 被 重 写 的 方法 如 下 所 示 : 

e OnKeyDown 一 一 当 一 个 键 被 按 下 并 且 没 有 被 活动 中 的 任何 视图 处 理 时 调用 

e onKeyUp 一 一 当 一 个 键 被 释放 并 且 没 有 被 活动 中 的 任何 视图 处 理 时 调用 

e onMenuItemSelected 一 一 当 用 户 选 择 了 面板 的 菜单 时 调用 ( 见 第 $ 章 ) 

e onMenuOpenec 当 用 户 打 开 了 面板 的 菜单 时 调用 ( 见 第 5 章 ) 


3.6.1 重 写 活动 中 定义 的 方法 
为 了 演示 活动 是 如 何 与 用 户 交 互 的 ， 下 面 的 示例 重 写 了 活动 的 基 类 中 定义 的 一 些 方法 。 
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(1) 使 用 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 并 命名 为 UIActivity。 
(2) 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 ( 符 换 TextView): 


<?xml version-"1.0" encoding-"utfí-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"fill parent" 


android:layout height-"fill parent" 


android:orientation-"vertical" > 


«TextView 
android 


android: 


«EditText 


android: 
android: 
android: 


«Button 


android: 


android 


android: 


«Button 


android: 
android: 


android 


android: 


</LinearLayout> 


:layout width="214dp" 
android: 


layout height="wrap content" 
text="Your Name" /> 


id="@+id/txt1" 
layout width="214dp" 


layout height="wrap content" 


id="@+id/btn1" 


:layout width="106dp" 
android: 


layout height="wrap content" 
text="0K" /> 


id="@+id/btn2" 
layout width="106dp" 


:layout height="wrap content" 


text="Cancel" /> 


/> 


(3) 在 UlActivityActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.UIActivity; 


import android.app.Activity; 


import android.os.Bundle; 


import android.view.KeyEvent; 


import android.widget.Toast; 


public class UlActivityActivity extends Activity I 
/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
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步 ， 单 击 方 问 键盘 上 的 下 策 头 键 。 观 察 屏 莽 上 显示 的 消息 ， 
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@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE DPAD CENTER: 
Toast .makeText (getBaseContext(), 
"Center was clicked", 
Toast.LENGTH LONG) .show() ; 
break; 
case KeyEvent.KEYCODE DPAD LEFT: 
Toast.makeText(getBaseContext(), 
"Left arrow was clicked", 
Toast.LENGTH LONG).show(); 
break; 
case KeyEvent.KEYCODE DPAD RIGHT: 
Toast.makeText(getBaseContext(), 
"Right arrow was clicked", 
Toast.LENGTH LONG).show(); 
break; 
case KeyEvent.KEYCODE DEAD UP: 
Toast.makeText(getBaseContext(), 
"Up arrow was clicked", 
Toast.LENGTH LONG).show(); 


break; 
case KeyEvent.KEYCODE DEAD DOWN: 
Toast.makeText(getBaseContext(), 
"Down arrow was clicked", 
Toast.LENGTH LONG).show(); 
break; 


F 
W^ SEA: ndrcid AU 


} 
return false; 
) Bl uiActivity 


Your Mame 


Wei-Meng Lee 


(4) X F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 
(5) 当 活 动 加 载 后 ， 在 EditText 中 输入 一 些 文本 。 下 一 


OK 


Cancel 


如 图 3-39 所 示 。 


示例 说 明 

当 加 载 活动 时 ， 光 标 将 在 EditText 视图 中 闪烁 ， 因 为 它 

在 MainActivity 类 中 ， 按 如 下 所 示 重 写 Activity 基 类 的 
onKeyDownO 方 法 : 


图 3-39 
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QOverride 
public boolean onKeyDown (int keyCode, KeyEvent event) 
{ 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE DPAD CENTER: 


//..- 
break; 

case KeyEvent.KEYCODE DEAD LEFT: 
//..- 
break; 

case KeyEvent.KEYCODE DPAD RIGHT: 
//..- 
break; 

case KeyEvent.KEYCODE DEAD UP: 
//..- 
break; 

case KeyEvent.KEYCODE DEAD DOWN: 
//..- 
break; 


} 


return false; 


在 Android F, “ate Fin EAE BENI, T BAR I Es OS AY PL Ep ak E] bh AE 

成 的 事件 。 本 例 中 ， 当 EditText 获得 焦点 并 且 您 按 下 了 一 个 键 时 ，EditText 视图 将 处 理 这 
事件 并 在 视图 中 将 您 刚刚 和 输入 的 字符 显示 出 来 。 然 而 ， 如 果 您 按 了 上 或 下 箭头 键 ，EditText 

视图 不 会 对 此 作 处 理 , 相反 会 将 这 个 事件 传递 给 活动 。 在 这 种 情况 下 , 将 调用 onKeyDown() 
方法 。 本 例 中 ， 您 检查 按 下 的 键 并 显示 一 条 消 奶 表明 该 键 被 按 下 了 。 可 以 看 到 ， 现 在 焦点 
转移 到 了 下 一 个 视图 上 ， 即 OK 按钮 。 

有 趣 的 是 ， 如 果 EditTe xt 视 图 内 已 经 有 了 一 些 文本 ， 并 且 光 标 位 于 文本 末尾 ， 那 么 
单 击 左 箭头 键 不 会 触发 onKeyDown0 事 件 ， 而 只 是 将 光标 向 左 移动 一 个 字符 。 这 是 由 于 
EditText 视图 已 经 处 理 了 这 一 事件 。 如 果 按 下 的 是 右 箭 头 键 ( 当 光标 位 于 文本 末尾 时 )， 将 调 
用 onKeyDown0 方 法 (因为 现在 EditText 视图 将 不 会 处 理 这 一 事件 )。 这 同样 适用 于 光标 位 
T EditText 视图 开始 的 情况 : 单 击 左 鼻头 将 触发 onKeyDown0O 事 件 ， 而 单 击 右 箭头 将 只 是 
将 光标 同 右 移动 一 个 字符 。 

当 OK 按钮 获得 焦点 时 ， 按 下 方 同 键盘 上 的 中 间 按 钮 。 可 以 看 到 Center was clicked 消 
县 没有 显示 出 来 。 这 是 由 于 Button 视图 本 号 处 理 了 单 击 事件 。 因 此 ，onKeyDown0 方 法 没 
有 捕获 这 一 事件 。 

还 要 注意 ，onKeyDownO 方 法 返回 一 个 boolean 类 型 的 结果 。 当 想 告诉 系统 您 已 经 处 理 
完 此 事件 并 且 系 统 不 要 再 作 进一步 的 处 理 时 ， 应 当 返 回 true. pi 考虑 下 列 当 每 一 个 键 
匹配 后 返回 true 时 的 情况 : 
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@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE DPAD CENTER: 
Toast.makeText (getBaseContext (), 
"Center was clicked", 
Toast. LENGTH LONG) .show(); 
/ /break; 
return true; 
case KeyEvent.KEYCODE DPAD LEFT: 
Toast.makeText (getBaseContext(), 
"Left arrow was clicked", 
Toast.LENGTH LONG).show(); 
/ /break; 
return true; 
case KeyEvent.KEYCODE DPAD RIGHT: 
Toast.makeText (getBaseContext(), 
"Right arrow was clicked", 
Toast.LENGTH LONG).show(); 
/ /break; 
return true; 
case Keybvent.KEYCODE DEAD UP: 
Toast.makeText (getBaseContext(), 
"Up arrow was clicked", 
Toast.LENGTH LONG).show(); 


/ /break; 
return true; 
case KeyEvent.KEYCODE DPAD DOWN: 
Toast.makeText(getBaseContext(), 
"Down arrow was clicked", 
Toast.LENGTH LONG).show(); 
/ break， 
return true; 
] 
return false; 


} 


如 果 测 试 一 下 ， 就 会 发 现 现在 不 能 使 用 季 头 键 在 视图 之 间 导 航 。 


3.6.2 ”为 视图 注册 事件 


当 用 户 和 视图 交互 时 ， 视 图 可 以 触发 事件 。 例 如 ， 当 用 户 触 碰 一 个 Button 视图 时 ， 您 
需要 响应 这 个 事件 以 便 能 够 采取 适当 的 动作 。 要 做 到 这 一 点 , 需要 为 视图 显 式 地 注册 事件 。 

使 用 上 一 节 讨论 的 同一 个 例子 ， 我 们 知道 那个 活动 有 两 个 Button 视图 ， 因 此 ， 可 以 使 
用 一 个 匿名 类 注册 按钮 单 击 事件 ， 如 下 所 示 : 
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package net.learn2develop.UIActivity; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.KeyEvent; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.Toast; 


public class UIActivityActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView(R.layout.main); 


//---the two buttons are wired to the same event handler--- 
Button btn1 = (Button) findViewById(R.id.btn1) ; 
btnl.setOnClickListener (btnListener) ; 


Button btn2 = (Button) findViewById(R.id.btn2) ; 
btn2.setOnClickListener (btnListener) ; 


} 
//---create an anonymous class to act as a button click listener--- 
private OnClickListener btnListener = new OnClickListener () 
{ 
public void onClick (View v) 
{ 
Toast. makeText (getBaseContext(), 
((Button) v).getText() + " was clicked", 
Toast.LENGTH LONG) .show() ; 
} 
}; 
@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) 
Ff: 
] 


BI Uisctvity 
现在 ， 无 论 您 按 下 的 是 OK 按钮 还 是 Cancel 按钮 ， 都 会 显 
示 出 相应 的 消息 (如 图 3-40 所 示 )， 这 证 明 该 事件 被 正确 地 连接 
起 来 了 。 
除了 为 事件 处 理 程 序 定 义 一 个 匿名 类 外 ， 还 可 以 定义 一 个 
匿名 内 部 类 来 处 理事 件 。 下 面 的 示例 显示 了 如 何 为 EditText T 
图 处 理 onFocusChange0 方 法 。 


Ok 


Cancel 


图 3-40 
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import android.widget.EditText; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


//---the two buttons are wired to the same event handler--- 
Button btnl = (Button)findViewById(R.id.btnl); 
btnl.setOnClickListener (btnListener); 


Button btn2 = (Button)findViewById(R.id.btn2); 
btn2.setOnClickListener(btnListener); 


/ /---create an anonymous inner class to act as an onfocus listener--- 
EditText txtl = (EditText)findViewById (R.id.txt1); 
txt1.setOnFocusChangeListener (new View.OnFocusChangeListener () 


{ 
@Override 
public void onFocusChange (View v, boolean hasFocus) { 
Toast.makeText(getBaseContext(), 
((EditText) v).getId() +" has focus - " + hasFocus, 
Toast.LENGTH LONG).show(); 
} 
h; 


注意 : 对 于 本 例 而 言 ， 需 要 确保 onKeyDown( 方 法 返回 false， 而 不 是 像 衣 一 


X EditText 视图 收 到 焦点 时 ， 屏 幕 上 将 输出 一 条 消息 ， 如 图 3-41 所 示 。 


各 
rd 4.0 


" UlActivity 


Cancel 


2131034112 has focus - true 


图 3-41 
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通过 使 用 匿名 内 部 类 ， 可 以 把 两 个 Button 视图 的 单 击 事件 处 理 程序 重 写 为 如 下 所 示 : 


//---the two buttons are wired to the same event handler--- 
Button btnl = (Button)findViewById(R.id.btnl); 
//btnl.setOnClickListener (btnListener); 
btnl.setoOnClickListener(new View.OnClickListener() { 

public void onClick(View v) { 

//---do something--- 

} 

)); 


Button btn2 = (Button) findViewByld(R.id.btn2); 
//btn2.setOnClickListener (btnListener) ; 
btn?2.setOnClickListener (new View.OnClickListener() { 

public void onClick (View v) | 

//---do something--- 

} 

)); 
应 该 使 用 哪个 方法 来 处 理事 件 ? 如 果 一 个 事件 处 理 程序 要 处 理 多 个 视图 ， 匿 名 类 会 很 
有 帮助 。 如 果 一 个 视图 有 一 个 事件 处 理 程 序 ， 匿 名 内 部 类 方法 (后 一 种 方法 ) 会 很 有 帮助 。 


3.7 Ax (M 
本 章 学 习 了 如 何在 Android 中 创建 用 户 界面 ， 还 学 习 了 可 以 用 来 在 Android 用 户 界面 


中 定位 视图 的 不 同 布局 。 由 于 Android 设备 文 持 多 种 屏幕 方 同 ， 所 以 需要 特别 注意 这 一 点 ， 
以 确保 您 的 用 户 界面 能 够 适应 屏幕 方向 的 改变 。 


1. dp 单位 和 px 单位 有 何不 同 ? 应 该 用 哪 一 个 来 指定 视图 的 尺寸 ? 

2. 为 什么 不 建议 使 用 AbsoluteLayout? 

3. onPause() 77 i: fll onSaveInstanceState() 77 1: £3 |n] b y] ? 

4. 列举 3 个 可 以 重 写 来 保存 活动 状态 的 方法 。 应 该 在 哪些 实例 中 使 用 各 个 方法 ? 
5. 如 何 回 Action Bar YSIS fF 3i ? 

练习 答案 参见 附录 C. 


本 章 主 要 内 容 
to gH 关键 概念 
LinearLayout 以 单行 或 单列 的 形式 排列 视 
AbsoluteLayout 可 用 于 指定 其 子 元 素 的 确切 位 置 
TableLayout 以 行 和 列 的 形式 组 织 视图 
RelativeLayout 可 用 于 指定 子 视图 相对 于 彼此 之 间 是 如 何 定 位 的 
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主 题 
FrameLayout 
ScrollView 


度量 单位 

适应 方 同 变 化 的 两 种 方法 

为 不 同方 器 使 用 不 同 的 XML 
Aft 


保持 活动 状态 的 3 种 方法 


获得 当前 设备 的 尺寸 
限制 活动 的 方 同 
Action Bar 


动作 项 


应 用 程序 图 标 


SE) 
关键 概念 
一 个 在 屏幕 上 可 以 用 来 显示 单个 视图 的 占 位 符 
一 种 特殊 类 型 的 FrameLayout， 因 为 它 可 以 使 用 户 滚动 显示 一 个 占 
据 的 空间 大 于 物理 显示 的 视图 列表 
使 用 dp 指定 视图 尺寸 ， 使 用 sp 指定 字体 大 小 
销 定 与 调整 大 小 和 重新 定位 
纵 同 用 户 界面 使 用 layout 文件 夹 ， 横 同 用 户 界 面 使 用 layout-land X 
FEE 
使 用 onPauseO 事 件 
使 用 onSaveInstanceState0 事 件 
使 用 onRetainNonConfieurationInstance0 事 件 
使 用 WindowManager 类 的 getDefaultDisplay(Q77 1X 
使 用 setRequestOrientation0 方 法 或 者 AndroidManifest.xml 文件 中 的 
android:screenOrientation 属性 
取代 了 较 早 的 Android 版 本 中 的 标题 栏 
动作 项 显示 在 Action Bar 的 右 侧 ， 创 建 它们 的 方法 与 创建 选项 菜单 
很 相似 
通常 用 于 返回 到 应 用 程序 的 主 活动 。 建 立 使 用 Intent 对 象 和 
Intent.FLAG ACTIVITY CLEAR TOP 标志 来 实现 这 种 功能 


y 


Tie AES tt APF 


本 章 将 介绍 以 下 内 容 : 
o 如 何 使 用 Android 中 的 基本 视图 设计 用 户 界面 
e 如 何 使 用 选取 器 视图 显示 项 列表 

o 如 何 使 用 列表 视图 显示 项 列表 

e 如 何 使 用 特殊 雁 片 


第 3 章 中 学 习 了 可 以 用 来 在 一 个 活动 中 定位 视图 的 不 同 布局 ， 还 学 习 了 可 以 用 来 适应 
不 同 屏幕 分 辨 率 和 尺寸 的 相关 技术 。 本 章 中 ， 您 将 了 解 到 可 以 用 来 为 应 用 程序 设计 用 户 界 
和 面 的 各 种 视图 。 

特别 地 ， 将 学 习 到 以 下 视图 组 : 

e 基本 视图 常用 的 视图 ， 如 TextView、EditText 和 Button 视图 

e iX B os TU A 可 以 使 用 户 从 一 个 列表 中 进行 选择 的 视图 ， 如 TimePicker 和 

DatePicker 视图 

e 列表 视 岁 一 一 显示 长 的 项 列表 的 视 多 ， 如 ListView 和 SpinnerView 视图 

e 4H 93g xl EBEIIEEPRIE T 

随后 的 章节 将 涵盖 本 章 未 讨论 到 的 其 他 视图 ， 如 模拟 和 数字 时 钟 视图 以 及 用 于 显示 图 
形 的 其 他 视图 等 。 


4.1 基本 视图 


首先 ， 我 们 探究 一 些 可 以 用 于 设计 Android 应 用 程序 的 用 户 界 面 的 基本 视图 : 
e TextView 

e EditText 

e Button 


e ImageButton 
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e CheckBox 
e ToggleButton 
e RadioButton 


e RadioGroup 


这 些 基 本 视图 可 以 用 来 显示 文本 信息 以 及 执行 一 些 基 本 的 选择 。 下 面 的 章节 将 详细 研 
究 所 有 这 些 视图 。 


4.1.1 TextView 视图 


当 创 建 一 个 新 的 Android IAIN, Eclipse 总 会 创建 一 个 包含 一 个 <TextView> 元 素 的 
main.xml 文件 (位 于 res/layout 文件 夹 下 ): 
<?xml version-"1.0" encoding-"utfí-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<TextView 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="@string/hello" /> 


</LinearLayout> 


TextView 4 A] HISK pn HIP akan XAR. hE REAR AI, EFE Android 应 用 程序 时 
AX MER SI. WR ELE A JP" np ELA A aS HU CAS, WU AE TextView 的 子 类 一 一 
EditText， 下 一 节 将 讨论 它 。 


注意 ;在 某 些 平台 上 ，TextView 常 被 称 为 标签 视图 。 其 唯一 的 目的 就 是 在 屏 
T 菇 上 显示 文本 ， 


4.1.2 Button, ImageButton, EditText. CheckBox、 ToggleButton, RadioButton 
和 RadioGroup 视图 


除了 最 经 常用 到 的 TextView 视图 之 外 ， 还 有 其 他 一 些 您 将 频繁 使 用 到 的 基础 视图 : 
表示 一 个 按钮 的 小 部 件 。 
与 Button 视图 类 似 ， 不 过 它 还 显示 一 个 图 像 。 


e Button 


e ImageButton 


e EditText TextView 视图 的 子 类 ， 还 允许 用 户 编 辑 其 文本 内 容 。 
e CheckBox 有 具 有 两 个 状态 的 特殊 按钮 类 型 ， 选 中 或 未 选中 。 


e RadioGroup 和 RadioButton RadioButton 有 两 个 状态 : 选中 或 未 选中 。RadioGroup 
用 来 把 一 个 或 多 个 RadioButton 视图 组 合 在 一 起 , 从 而 在 该 RadioGroup 中 只 人 允许 一 
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个 RadioButton 被 选中 。 
e ToggleButton 用 一 个 灯光 指示 器 来 显示 选中 /未 选中 状态 。 
下 和 面 的 “ 试 一 试 ” 揭 示 了 了 这些 视图 工作 原理 的 细节 。 


使 用 基本 视图 


BasicViewsl.zip TCX fff uJ LAGE Wrox.com E FÉ 


(1) 使 用 Eclipse 创建 一 个 Android 项 目 ， 命 名 为 BasicViewl. 
(2) 在 位 于 res/layout 文件 夹 下 的 main.xml 文件 中 添加 下 列 粗 体 显 示 的 元 素 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button android:id="@+id/btnSave" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text=" save" /> 


«Button android:id="@+id/btnOpen" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text-"Open" /» 


<ImageButton android: id="@+id/btnImg1" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: src="@drawable/ic launcher" /> 


<EditText android: id="@+id/txtName" 
android: layout width="fill parent" 
android: layout height="wrap content" /> 


<CheckBox android:id="@+id/chkAutosave" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text-"Autosave" /> 


<CheckBox android:id="@+id/star" 
style-"?android:attr/starStyle" 
android:layout width-"wrap content" 
android:layout height="wrap content" /> 


<RadioGroup android:id="@+id/rdbGp1" 
android:layout width-"fill parent" 
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android: layout height="wrap content" 
android:orientation-"vertical" > 


<RadioButton android: id="@+id/rdb1i" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Option 1" /> 


<RadioButton android: id="@+id/rdb2" 
android: layout width-"fill parent" 
android:layout height="wrap content" 
android: text="Option 2" /> 


</RadioGroup> 


<ToggleButton android: id="@+id/toggle1" 
android: layout width="wrap content" 
android: layout height-"wrap content" /? 


</LinearLayout> 


(3) 要 观察 视图 的 效果 ， 可 在 Eclipse 中 选择 项 目 名 称 并 按 F11 键 进行 调试 。 图 4-1 JE 
示 了 在 Android 模拟 器 中 显示 的 不 同 视 图 。 

(4) 单 击 不 同 的 视图 并 注意 它们 在 外 观 和 感觉 上 的 变化 。 图 4-2 展示 了 视图 的 以 下 改变 : 

e 第 1 个 CheckBox 视图 (Autosave) 被 选中 。 

e 第 2 个 CheckBox 视图 ( 星 形 ) 被 选中 。 

e 第 2 个 RadioButton(Option 2) 被 选中 。 

e ToggleButton 被 打开 。 


: 
T Wm E * 
2^ S554 ndr 40 E| SSt4Andrnid AD 


BB Basicviews1 B Basicviews1 


Save Save 


Autosave v” Autosave 
Option 1 Option 1 
Option 2 è Option 2 


OFF ON 


图 4-1 图 4-2 
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示例 说 明 

到 目前 为 止 ， 所 有 的 视图 都 是 相对 简单 的 一 一 使 用 <LinearLayout> 元 素 将 它们 一 一 列 
Ih, ASEAN, “EES ERIE E. 

对 于 第 1 个 Button, layout width 属性 被 设置 为 fill parent， 因 此 其 宽度 将 占据 整个 屏 
各 的 宽度 : 


<Button android:id="@+id/btnSave" 
android:layout width="fill parent" 


android: layout height="wrap content" 
android:text="save" /> 
对 于 第 2 个 Button, layout width 属性 被 设置 为 wrap_content， 因 此 其 宽度 将 是 其 所 包 
含 内 容 的 宽度 一 一 具体 来 说 ， 就 是 显示 的 文本 (也 就 是 “Open”) 的 宽度 : 
«Button android:id="@+id/btnOpen" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android:text-"Open" /> 
ImageButton 显示 了 一 个 带 有 图 像 的 按钮 。 图 像 通过 src 属性 设置 。 本 例 中 ， 使 用 曾 用 
作 应 用 程序 图 标的 图 像 : 
<ImageButton android:id="@+id/btnImg1" 
android:layout width="fill parent" 
android: layout height="wrap content" 
android:src="@drawable/ic launcher" /> 
EditText 视图 显示 了 一 个 矩形 区 域 , 用 户 可 以 向 其 中 输入 一 些 文本 。layout_height 属性 
被 设置 为 wrap_content， 这 样 ， 如 果 用 户 输入 一 个 长 的 文本 串 ，EditText 的 高 度 将 随 大 内 容 
目 动 调整 (如 图 4-3 所 示 )。 
<EditText android:id="@+id/txtName" 


android:layout width="fill parent" 
android: layout height-"wrap content" /> 


This ts a long sentence that spans 
across multiple lines... 


v^ Autosave 


xi 


图 4-3 
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CheckBox 显示 本 一 个 用 户 可 以 通过 轻 点 眼 标 进行 选中 或 取消 选中 的 复 选 框 : 


<CheckBox android:id="@+id/chkAutosave" 
android: layout width="fill parent" 
android:layout height="wrap content" 
android:text-"Autosave" /» 


如 果 您 不 喜欢 CheckBox 的 默认 外 观 ， 可 以 对 其 应 用 一 个 样式 属性 ， 使 其 显示 为 其 他 
图 像 ， 如 星 形 : 


<CheckBox android:id="@+id/star"™ 
style="?android:attr/starStyle" 
android: layout width="wrap content" 
android:layout height-"wrap content" /> 


style 属性 的 值 的 格式 如 下 所 示 : 


? [package: ] [type: ] name 


RadioGroup 包含 了 两 个 RadioButton。 这 一 点 很 重要 ， 因 为 单 选 按钮 通常 用 来 表示 多 
个 选项 以 便 用 户 选择 。 当 选择 了 RadioGroup 中 的 一 个 RadioButton 时 ,其 他 所 有 RadioButton 
就 目 动 取消 选择 : 


<RadioGroup android:id="@+id/rdbGpl" 
android: layout width="fill parent" 
android:layout height="wrap content" 
android:orientation-"vertical" > 


«RadioButton android:id="@+id/rdbl1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Option 1" /» 


«RadioButton android:id="@+id/rdb2" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Option 2" /» 


«/RadioGroup» 


注意 ，RadioButton 是 亚 直 排列 的 ， 一 个 位 于 另 一 个 之 上 。 如 果 想 要 水 平 排列 ， 需 要 把 
orientation 属性 改 为 horizontal。 还 需要 确保 RadioButton 的 layout width 属性 被 设置 为 
wrap content: 


«RadioGroup android:id="@+id/rdbGpl" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:orientation-"horizontal" > 
<RadioButton android:id-"Q-cid/rdbl" 

android:layout width="wrap content" 
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android:text="Option 1" /> 
<RadioButton android:id="@+id/rdb2" 
android:layout width="wrap content" 


android:layout height="wrap content" 


android:text="Option 2" /> 
</RadioGroup> 


图 4-4 显示 了 水 平 排列 的 RadioButton 。 
Option 1 Option 2 


QFE 


图 4-4 
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ToggleButton 显示 了 一 个 矩形 按钮 ， 用 户 可 以 通过 单 击 它 来 实现 开 和 关 的 切换 ; 


<ToggleButton android:id="@tid/togglel" 
android: layout width="wrap content" 
android:layout height-"wrap content" /> 


这 个 例子 中 ， 始 终 保 持 一 致 的 一 件 事情 是 每 个 视图 都 有 一 个 设置 为 特定 值 的 id 属性 ， 


如 Button 视图 中 所 示 : 


«Button android:id="@+id/btnSave" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android:text="@string/save" /> 


id 属性 是 视图 的 标识 符 ， 因 此 可 以 在 以 后 使 用 
View.findViewById0 或 Activity fndViewById0 方 法 来 检 


刚才 看 到 的 各 种 视图 是 在 模拟 Android 4.0 智能 手 


机 的 Android 模拟 磺 上 进行 测试 的 。 当 运行 在 较 早 版 本 
的 Android 智能 手机 上 时 ， 它 们 会 是 什么 样子 ?运行 在 
Android 平板 电脑 上 时 ， 又 会 是 什么 样子 ? 

图 4-5 显示 了 将 AndroidManifestxml 文件 的 
android:minSdkVersion 属性 改 为 10， 并 在 运行 Android 
2.3.6 的 Google Nexus S. 上 运行 时 ， 活 动 的 外 观 : 


<uses-sdk android:minSdkVersion="10" /> 


图 4-6 显示 了 将 AndroidManifestxml 文件 中 的 
android:minSdk Version 属性 改 为 13, 并 在 运行 Android 3.2.1 
的 Asus Eee Pad Transformer 上 运行 时 ， 活 动 的 外 观 : 


| |Autosave 


* 


( — ) Option 1 


( —.)Option 2 


| OFF 


图 4-5 
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e BasicViews 1 


Option 1 
Option 2 


OFF 


图 4-6 


如 果 将 android:minSdk Version 属性 设 为 8 或 更 小 ， 然 后 在 运行 Android 3.2.1 的 Asus Eee 


Pad Transformer 上 运行 ， 会 看 到 额外 的 一 个 按钮 ， 如 图 4-7 Pra. 


® Stretch to fill screen 


Zoom to fill screen 


图 4-7 


点 击 该 按钮 会 出 现 两 个 选项 ， 它 们 分 别 可 以 将 活动 拉 伸 到 填充 整个 屏幕 (默认 选项 )， 
pr SABE BE. lk 4-8 所 示 。 
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Autosave 


Stretch to fill screen 


* foomto fill screen 


图 4-8 


fH] rix.» AK SDK 版 本 设 为 8 或 更 低 的 应 用 程序 可 以 在 最 初 设 计 的 屏幕 尺寸 上 显 
示 ， 也 可 以 自动 拉 伸 以 填充 屏幕 (默认 行为 )。 
现在 ， 您 已 经 了 解 了 一 个 活动 的 多 种 视图 的 外 观 ， 下 面 的 “ 试 一 试 ” 将 教 您 如 何以 编 
程 方式 控制 它们 。 
E 处 理 视图 事件 
a) 使 用 前 面 的 “ 试 一 试 ” 所 创建 的 BasicViewsl 项 目 ， 修 改 BasicViewslActivity.java 
文件 ， 添 加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.BasicViewsl; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 

import android.widget.CheckBox; 

import android.widget.RadioButton; 

import android.widget.RadioGroup; 

import android.widget.RadioGroup.OnCheckedChangeListener; 
import android.widget.Toast; 

import android.widget.ToggleButton; 


public class BasicViewslActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 

super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 
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//---Button view--- 
Button btnOpen = (Button) findViewById(R.id.btnOpen); 
btnOpen.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
DisplayToast("You have clicked the Open button"); 


H); 


//---Button view--- 
Button btnSave = (Button) findViewById(R.id.btnSave); 
btnSave.setOnClickListener(new View.OnClickListener() 
{ 
public void onClick(View v) { 
DisplayToast ("You have clicked the Save button"); 


Ill 


/ / --- CheckBox--- 
CheckBox checkBox - (CheckBox) findViewById(R.id.chkAutosave); 
checkBox.setOnClickListener (new View.OnClickListener () 
{ 
public void onClick (View v) | 
if (((CheckBox)v).isChecked()) 
DisplayToast("CheckBox is checked"); 
else 
DisplayToast("CheckBox is unchecked"); 


)); 


/ / --- RadioButton--- 
RadioGroup radioGroup = (RadioGroup) findViewById(R.id.rdbGp1); 
radioGroup.setOnCheckedChangeListener (new OnCheckedChangeListener () 
{ 
public void onCheckedChanged (RadioGroup group, int checkedId) { 
RadioButton rbl = (RadioButton) findViewById(R.id.rdb1); 
if (rbl.isChecked()) | 
DisplayToast ("Option 1 checked!"); 
} else { 
DisplayToast ("Option 2 checked!"); 


Hh); 


/ / ---ToggleButton--- 
ToggleButton toggleButton - 


(ToggleButton) findViewById(R.id.togglel) ; 


toggleButton.setOnClickListener (new View.OnClickListener () 


public void onClick(View v) { 
if (((ToggleButton)v) .isChecked () ) 
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DisplayToast ("Toggle button is On"); 
else 
DisplayToast ("Toggle button is Off"); 


} 
)); 

} 

private void DisplayToast (String msg) 

{ 

Toast.makeText (getBaseContext(), msg, 
Toast.LENGTH SHORT) .show() ; 

} 


) 


(2) 4% F11 键 在 Android 模拟 需 中 调试 项 目 。 
(3) 单 击 不 同 的 视图 ， 观 察 在 Toast BA Se zn HIE E o 


示例 说 明 
为 了 处 理 每 一 个 视图 所 触发 的 事件 ， 首 先 需要 以 编程 方式 定位 在 onCreate0 事 件 中 所 
创建 的 视图 。 做 法 是 使 用 Acitivity 基 类 的 findViewById0 方 法 ， 传 入 该 视图 的 ID。 


//---Button view--- 
Button btnOpen = (Button) findViewById(R.id.btnOpen); 


setOnClickListenerO 方 法 注册 了 一 个 在 视图 被 单 击 时 调用 的 回调 函数 : 


btnOpen.setOnClickListener (new View.OnClickListener() { 
public void onClick(View v) { 
DisplayToast ("You have clicked the Open button"); 
} 
1); 


当 单 击 视图 时 ， 将 调用 onClick0 方 法 。 
对 于 CheckBox， 为 了 确定 其 状态 ， 必 须 把 onClick0 方 法 的 参数 类 型 转换 成 一 个 
CheckBox， 然 后 检查 它 的 isChecked0 方 法 来 确定 其 是 否 被 选中 : 


CheckBox checkBox = (CheckBox) findViewById(R.id.chkAutosave); 
checkBox.setOnClickListener (new View.OnClickListener() 
{ 
public void onClick(View v) { 
if (((CheckBox)v).isChecked()) 
DisplayToast("CheckBox is checked"); 
else 
DisplayToast("CheckBox is unchecked"); 
] 
1); 


对 于 RadioButton， 需 要 使 用 RadioGroup 的 setOnCheckedChangeListener0 方 法 注册 一 


个 回调 函数 ， 以 便 在 该 组 中 被 选中 的 RadioButton 发 生变 化 时 调用 : 
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//——-RadioButton--- 
RadioGroup radioGroup = (RadioGroup) findViewById (R.id.rdbGpl); 
radioGroup.setOnCheckedChangeListener (new OnCheckedChangeListener() 


{ 
public void onCheckedChanged(RadioGroup group, int checkedId) { 
RadioButton rbl = (RadioButton) findViewById(R.id.rdbl); 
if (rbl.isChecked()) { 
DisplayToast ("Option 1 checked!"); 
} else | 
DisplayToast("Option 2 checked!"); 
} 


)); 
当选 中 一 个 RadioButton 时 ， 将 触发 onCheckedChanged0 方 法 。 在 这 一 过 程 中 ， 找 到 
那些 单个 的 RadioButton， 然 后 调用 它们 的 isChecked0 方 法 来 确定 是 哪个 RadioButton 被 选 
tH. 或 者 ，onCheckedChanged0 方 法 包含 第 2 个 参数 ， 其 中 包含 被 选 定 RadioButton 的 唯一 
标识 符 。 
ToggleButton 的 工作 方式 与 CheckBox 类 似 。 
到 目前 为 止 ， 为 了 处 理 视图 上 的 事件 ， 首 先 再 要 获得 视图 的 一 个 引用 ， 然 后 再 要 注册 
个 回调 函数 来 处 理事 件 。 还 有 另外 一 种 处 理 视图 事件 的 方法 。 以 Button 为 例 ， 可 以 回 其 
添加 一 个 名 为 onClick 的 属性 : 
<Button android:id="@+id/btnSave" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="@string/save" 
android: onClick="btnSaved clicked"/> 
onClick 属性 指定 了 按钮 的 单 击 事件 。 该 属性 的 值 就 是 事件 处 理 程序 的 名 称 。 因 此 ,为 
处 理 按钮 的 单 击 事件 ,只 需要 创建 一 个 名 为 btnSaved clicked 的 方法 , 如 下 面 的 示例 所 示 ( 注 
意 该 方法 必须 有 一 个 View 类 型 的 参数 ); 
public class BasicViewslActivity extends Activity I 
public void btnSaved clicked (View view) { 


DisplayToast("You have clicked the Save button1"); 
) 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView(R.layout.main); 


LEET 
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private void DisplayToast (String msg) 
{ 
Toast.makeText (getBaseContext(), msg, 
Toast.LENGTH SHORT) .show(); 


} 

如 果 与 前 面 使 用 的 方法 进行 比较 ， 会 发 现 这 种 方法 更 加 简单 。 使 用 哪 种 方法 取决 于 您 
目 己 ， 但 本 书 中 主要 使 用 后 面 这 种 方法 。 

4.1.3 ProgressBar 视图 

ProgressBar 视图 提供 了 一 些 下 在 进行 的 任务 的 视 沉 反馈， 如 当 您 在 后 台 执 行 一 个 任务 
时 。 例 如 ， 您 可 能 正 从 Web 上 下 载 一 些 数据 并 再 要 更 新 用 户 的 下 载 状态 。 在 这 种 情况 下 ， 
使 用 ProgressBar 视图 来 完成 这 一 任务 是 一 个 不 错 的 选择 .下 面 的 活动 演示 了 如 何 使 用 这 个 
视图 。 


使 用 ProgressBar 视图 


BasicViews2.zip fCfZ ff ALA Wrox.com E Ft 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews2 的 Android Jii H . 
(2) 修改 位 于 res/layout 文件 夹 下 的 main-xml 文件 ， 添 加 下 列 粗 体 显示 的 代码 ; 


<?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<ProgressBar android: id="@+id/progressbar" 
android: layout width="wrap content" 
android: layout height="wrap content" /? 


</LinearLayout> 


(3) 在 BasicViews2Activity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.BasicViews2; 


import android.app.Activity; 
import android.os.Bundle; 

import android.os.Handler; 

import android.view.View; 

import android.widget. ProgressBar ; 
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public class BasicViews2Activity extends Activity I 
static int progress; 
ProgressBar progressBar; 
int progressStatus = 0; 
Handler handler = new Handler (); 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


progress = 0; 


progressBar = (ProgressBar) findViewById(R.id.progressbar) ; 


//---do some work in background thread--- 
new Thread(new Runnable () 
{ 

public void run() 


{ 
//---do some work here--- 
while (progressStatus < 10) 
{ 
progressStatus = doSomeWork () ; 
} 
//---hides the progress bar--- 
handler .post (new Runnable () 
{ 
public void run() 
{ 
//---0 - VISIBLE; 4 - INVISIBLE; 8 - GONE--- 
progressBar.setVisibility (View.GONE) ; 
} 
)); 


//---do some long running work here--- 
private int doSomeWork() 


{ 
try { 
//---simulate doing some work--- 
Thread.sleep (500) ; 
} catch (InterruptedException e) 
{ 
e.printStackTrace(); 
} 
return ++progress; 
} 
}) .start(); 
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} 


(4) f F11 键 在 Android 模拟 器 中 调试 项 目 。 图 4-9 显示 了 ProgressBar 的 动画 。 大 约 5 
秒 钟 后 ， 它 将 消失 。 


Fr 
B | 55544 ndrod_40 


el BasicViews2 


O 


图 4-9 

示例 说 明 

ProgressBar 视图 的 默认 模式 是 不 确定 的 一 一 也 就 是 说 ， 它 显示 一 个 循环 的 动画 。 这 种 
模式 对 于 完成 时 间 没 有 明确 指示 的 任务 是 非常 有 用 的 , 例如 当 您 向 一 个 Web 服务 发 送 一 些 
数据 并 等 待 服务 器 的 啊 应 时 。 如 果 只 是 把 <ProgressBar> 元 素 放 入 main.xml 文件 中 ， 它 会 不 
断 地 显示 一 个 旋转 的 图 标 。 当 后 台 任 务 已 经 完成 时 ， 需 要 您 来 使 它 停止 旋转 。 

已 在 Java 文件 中 添加 的 代码 显示 了 如 何 分 配 一 个 后 台 线 程 来 模拟 执行 一 些 长 时 间 运 
行 的 任务 。 要 做 到 这 一 点 ， 可 以 配合 使 用 Thread 类 和 一 个 Runnable 对 象 。run0 方 法 启动 
线程 的 执行 ,在 这 种 情况 下 调用 doSomeWork0O 方 法 来 模拟 做 一 些 工 作 。 当 模拟 工作 完成 后 
(大 约 5 秒 种 之 后 )， 使 用 Handler 对 象 给 线程 发 送 一 条 消 姑 来 取消 ProgressBar: 

//---do some work in background thread--- 


new Thread(new Runnable() 


{ 


public void run () 
{ 
//---do some work here--- 
while (progressStatus « 10) 
{ 
progressStatus = doSomeWork (); 


} 


//---hides the progress bar--- 
handler.post (new Runnable() 
{ 
public void run() 
{ 
//-——0 - VISIBLE; 4 — INVISIBLE; 8 — GONE--- 
progressBar.setVisibility (View.GONE) ; 
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//---do some long running work here--- 
private int doSomeWork() 
| 
try | 
//---simulate doing some work--- 


Thread.sleep(500); 
} catch (InterruptedException e) 
{ 
e.printStackTrace(); 
} 
return ++progress; 
} 
H) -start (); 


当 任 务 完 成 时 ， 通 过 设置 ProgressBar 的 Visibility 属性 为 View.GONE ( 值 8) 来 隐藏 它 。 
INVISIBLE 和 GONE 常量 的 区 别 在 于 INVISIBLE 常量 只 是 隐藏 ProgressBar(ProgressBar 
仍旧 在 活动 中 占据 空间 )。GONE 常量 则 从 活动 中 移 除 ProgressBar 视图 ， 它 不 再 占据 任何 
空间 。 

下 面 的 “ 试 一 试 ” 滨 示 了 如 何 改 变 ProgressBar 的 外 观 。 

试 一 试 定制 ProgressBar 视图 

a) 使 用 前 面 的 “ 试 一 试 ” 中 所 创建 的 BasicViews2 项 目 ， 按 如 下 所 示 修 改 main.xml 
文件 : 

<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 

android:layout width-"fill parent" 


android:layout height-"fill parent" 
android:orientation-"vertical" > 


<ProgressBar android: id="@+id/progressbar" 
android: layout width="wrap content" 
android: layout height="wrap content" 
style="@android: style/Widget.ProgressBar.Horizontal" /> 


</LinearLayout> 

(2) 修改 BasicViews2Activityjava 文件 ， 添 加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.BasicViews2; 

import android.app.Activity; 

import android.os.Bundle; 

import android.os.Handler; 


import android.view.View; 
import android.widget.ProgressBar; 
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public class BasicViews2Activity extends Activity { 
static int progress; 
ProgressBar progressBar; 
int progressStatus = 0; 
Handler handler = new Handler(); 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


progress = 0; 
progressBar = (ProgressBar) findViewByld(R.id.progressbar) ; 


progressBar.setMax (200); 


//---do some work in background thread--- 
new Thread (new Runnable() 


{ 
public void run () 


{ 
//---do some work here--- 
while (progressStatus « 100) 
{ 
progressStatus = doSomeWork(); 
//---Update the progress bar--- 
handler .post (new Runnable () 
{ 
public void run() { 
progressBar.setProgress (progressStatus) ; 
} 
)); 
} 


//---hides the progress bar--- 
handler.post (new Runnable() 


{ 
public void run() 
{ 
//---0 - VISIBLE; 4 - INVISIBLE; 8 - GONE--- 
progressBar.setVisibility(View.GONE); 
j 
)); 
} 
//---do some long running work here--- 


private int doSomeWork() 
{ 
try | 
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//---simulate doing some work--- 
Thread.sleep (500); 

) catch (InterruptedException e) 

{ 


e.printStackTrace (); 


— P 
re 
} 
(3) TZ F11 BETE Android 模拟 器 中 调试 项 目 。 
(4) 图 4-10 展示 了 正 显 示 进 度 的 ProgressBar。 当 进度 达到 $0% 时 ，ProgressBar 消失 。 


F 
8' 5554:Android_4.0 


P" BasicViews2 


图 4-10 


示例 说 明 
为 了 使 ProgressBar 水 平 显 示 ， 只 要 设置 其 style 属性 为 @android:style/Widget.Progress 
Bar. Horizontal: 
«ProgressBar android:id="@+id/progressbar" 
android: layout width="wrap content" 


android:layout height="wrap content" 
style="@android: style/Widget.ProgressBar.Horizontal" /> 


为 了 显示 进度 ， 调 用 setProgress0) 方 法 ， 传 入 一 个 表示 进度 的 整数 : 


/f—--Update the progress bar--- 
handler.post (new Runnable () 
{ 
public void run() { 
progressBar.setProgress (progressStatus) ; 
} 
)); 
在 本 例 中 ， 设 置 了 ProgressBar 的 范围 为 0 一 200( 通 过 setMax0 方 法 )。 因 此 ，ProgressBar 
将 在 中 途 停止 并 消失 (由 于 仅仅 在 progressStatus 小 于 100 时 才 持 续 调 用 doSomeWorkO 方 
法 )。 为 了 确保 ProgressBar 只 有 当 进度 达到 100% 时 才 消 失 ， 可 以 设置 最 大 值 为 100， 或 者 
修改 while 循环 为 当 progressStatus 达到 200 时 停止 ， 如 下 所 示 : 


//---do some work here--- 
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while (progressStatus < 200) 


除了 本 例 中 为 ProgressBar 使 用 的 水 平 样式 ， 还 可 以 使 用 以 下 常量 : 
e Widget.ProgressBar.Horizontal 

e Widget.ProgressBar.Small 

e Widget.ProgressBar.Large 

e Widget.ProgressBar.Inverse 

e Widget.ProgressBar.Small.Inverse 


e Widget.ProgressBar.Large.Inverse 


4.1.4 AutoCompleteTextView 视图 


AutoCompleteTextView 是 一 种 与 EditText 类 似 的 视图 (实际 上 ， 它 是 EditText 的 子 类 )， 
只 不 过 它 还 在 用 户 输 入 时 目 动 显示 完成 建议 的 列表 。 和 下面 的 “ 试 一 试 ” 展 示 了 如 何 利用 
AutoCompleteTextView 来 目 动 协助 用 户 完 成 文本 输入 。 


使 用 AutoCompleteTextView 


BasicViews3.zip CE X ff AT Ll f£ Wrox.com E FR 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews3 的 Android Jil H . 
(2) 按 如 下 粗 体 显示 内 容 修改 位 于 res/layout 文件 夹 下 的 main.xml X fF: 


<?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Name of President" /» 


<AutoCompleteTextView android: id="@+id/txtCountries" 
android: layout width-"fill parent" 
android: layout height="wrap content" /? 
</LinearLayout> 
(3) 在 BasicViews3 Activity. java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.BasicViews3; 


import android.app.Activity; 
import android.os.Bundle; 
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import android.widget.ArrayAdapter; 
import android.widget.AutoCompleteTextView; 


public class BasicViews3Activity extends Activity I 

String[] presidents = { 
"Dwight D. Eisenhower", 
"John F. Kennedy", 
"Lyndon B. Johnson", 
"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 


ES 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


ArrayAdapter<String> adapter = new ArrayAdapter<String> (this, 
android.R.layout.simple dropdown 
item lline, presidents); CET 
AutoCompleteTextView textView = 
(AutoCompleteTextView) 
findViewById(R.id.txtCountries); 


Bf Basicviews3 


Name of President 


textView.setThreshold (3); Bush 
textView.setAdapter (adapter); 


George H. W. Bush 

} 

(4) 按 F11 BEZE Android 模拟 器 中 调试 应 用 程序 。 
如 图 4-11 Pras, El) AutoCompleteTextView 中 输入 时 ， 
会 随 之 显示 一 个 匹配 名 字 的 列表 。 

示例 说 明 

在 BasicViews3Activity 类 中 ， 首 先 创建 了 一 个 包含 

HARA TH] String 数组 : 


George W. Bush 


String[] presidents = 1 
"Dwight D. Eisenhower", 图 4-11 
"John F. Kennedy", 
"Lyndon B. Johnson", 
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"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 
be 
Array Adapter 对 象 管 理 将 由 AutoCompleteTextView 显示 的 字符 串 数组 。 在 先前 的 例子 
中 ， 将 AutoCompleteTextView 设置 为 以 simple dropdown item lline 模式 显示 : 
ArrayAdapter<String> adapter = new ArrayAdapter<String> (this, 
android.R.layout.simple dropdown item lline, presidents); 


setThreshold0 方 法 设置 建议 以 下 拉 沫 单 形 式 出 现 前 用 户 必须 得 入 的 最 少 字 符 个 数 : 
textView.setThreshold(3); 
为 AutoCompleteTextView 显示 的 建议 列表 从 ArrayAdapter 对 象 获得 : 


textView.setAdapter (adapter); 


42 选取 器 视图 


选择 日 斯 和 时 间 是 您 在 一 个 移动 应 用 程序 中 需要 执行 的 常见 任务 之 一 。Android 通过 
TimePicker 和 DatePicker 视图 来 支持 这 一 功能 。 下 面 的 小 节 将 曾 述 如 何在 活动 中 使 用 这 些 
视图 。 
4.2.1 TimePicker 视图 


TimePicker 视图 可 以 使 用 户 按 24 小 时 或 AM/PM 模式 选择 一 天 中 的 某 个 时 间 。 下 面 的 
“ 试 一 试 ” 展 示 了 如 何 使 用 这 一 视图 。 


使 用 TimePicker 视图 


BasicViews4.zip fCfZ X PERI UUTE Wrox.com E FR 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews4 的 Android Ji H . 
(2) 修改 位 于 res/layout 文件 夹 下 的 main.xml 文件 ， 添 加 下 列 粗 体 显 示 的 行 : 


<?xml version-"1.0" encoding-"utí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 
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<TimePicker android:id="@+id/timePicker" 
android: layout width-"wrap content" 
android: layout height-"wrap content" /? 


«Button android:id-"8c-id/btnSet" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"I am all set!" 


android:onClick-"onClick" /> 
</LinearLayout> 


(3) 在 Eclipse 中 选择 该 项 目的 名 称 并 按 F11 键 在 
Android 模拟 器 中 调试 应 用 程序 。 图 4-12 显示 了 运用 中 
的 TimePicker。 除 了 单 击 加 (和 减 (一 ) 按 钮 外 ， 还 可 以 
使 用 设备 上 的 数字 键盘 来 修改 小 时 和 分 钟 ， 单 击 AM TE 
钮 在 AM 和 PM 之 间 切 换 。 

(4) 3x|"| Eclipse, 7E BasicViews4Activityjava 文件 
中 添加 下 列 粗 体 显示 的 语句 


package net.learn2develop.BasicViews4; 


import 
import 
import 
import 
import 


public 


= 
8» 33234;^ndraid dD 


| am all set! 


android.app.Activity; 
android.os.Bundle; 
android.view.View; 
android.widget.TimePicker; 
android.widget.Toast; 


图 4-12 


class BasicViews4Activity extends Activity I 


TimePicker timePicker; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) [| 


super.onCreate(savedInstancesState); 
setContentView(R.layout.main); 


timePicker = (TimePicker) findViewById(R.id.timePicker); 
timePicker.setIs24HourView(true); 


public void onClick(View view) { 


Toast.makeText (getBaseContext(), 
"Time selected:" + 
timePicker.getCurrentHour() + 
":"U + timePicker.getCurrentMinute(), 
Toast.LENGTH SHORT).show(); 


e BasicViews4 


} 

(5) f F11 键 在 Android 模拟 器 上 调试 应 用 
程序 。 这 一 次 , TimePicker 将 以 24 小 时 格式 显示 。 
单 击 Button 将 显示 您 在 TimePicker 中 设置 好 的 时 
间 ( 如 图 4-13 所 示 )。 


示例 说明 

TimePicker 显示 了 一 个 可 以 让 用 户 设置 时 间 
的 标准 用 户 界 面 。 默 认 情 况 下 ， 它 以 AMPM fit 
式 显 示 时 间 。 如 果 想 要 以 24 小 时 格式 来 显示 , 可 
以 使 用 setIls24HourView() 77 i: « 

为 了 以 编程 方式 获得 用 户 设置 的 时 间 ， 可 以 
使 用 getCurrentHour()#ll getCurrentMinute() 7; 7: : 


Toast.makeText(getBaseContext(), 
"Time selecrped-" + 
timePicker.getCurrentHour() + 
":" + timePicker.getCurrent 
Minute (), 
Toast.LENGTH SHORT) .show(); 
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" BasicViews4 


| am all set! 


Time selected:5:30 


图 4-13 


vA 注意 : getCurrentHourO 方 法 总 是 返回 24 小 时 格式 的 时 间 , 也 就 是 返回 一 个 0 ~ 


23 之 间 的 值 。 


虽然 可 以 在 一 个 活动 中 显示 TimePicker, 但 更 好 的 方法 是 在 一 个 对 话 框 窗口 中 显示 它 。 
这 样 一 旦 设置 好 时 间 ，TimePicker 就 会 消失 ， 不 再 占据 活动 中 的 任何 宇 间 。 下 面 的 “ 试 


试 ” 展 示 了 如 何 做 到 这 一 点 。 
试 一 试 使 用 对 话 框 显示 TimePicker 视图 


(1) 使 用 先前 “ 试 一 试 ” 中 所 创建 的 BasicViews4 ITH, feu Fateh 


BasicViews4Activity.java X fF: 


package net.learn2develop.BasicViews4; 


import java.text.SimpleDateFormat; 
import java.util.Date; 


import android.app.Activity; 

import android.app.Dialog; 

import android.app.TimePickerDialog; 
import android.os.Bundle; 
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import android.view.View; 
import android.widget.TimePicker; 
import android.widget.Toast; 


public class BasicViews4Activity extends Activity { 
TimePicker timePicker; 


int hour, minute; 
static final int TIME DIALOG ID = 0; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


timePicker = (TimePicker) findViewById(R.id.timePicker); 
timePicker.setIs24HourView (true); 


showDialog (TIME DIALOG ID); 


@Override 
protected Dialog onCreateDialog(int id) 
{ 

switch (id) { 

case TIME DIALOG ID: 

return new TimePickerDialog ( 
this, mTimeSetListener, hour, minute, false); 
} 


return null; 


private TimePickerDialog.OnTimeSetListener mTimeSetListener = 
new TimePickerDialog.OnTimeSetListener () 
{ 
public void onTimeSet ( 
TimePicker view, int hourOfDay, int minuteOfHour) 


hour = hourOfDay; 
minute = minuteOfHour; 


SimpleDateFormat timeFormat = new SimpleDateFormat ("hh:mm aa") ; 
Date date = new Date(0,0,0, hour, minute) ; 
String strDate = timeFormat.format (date) ; 


Toast.makeText(getBaseContext(), 


"YOu have selected " 二 strDate, 
Toast.LENGTH SHORT).show(); 


1/4 
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I 


public void onClick(View view) { 
Toast.makeText (getBaseContext (), 
"Time selected:™ + 
timePicker.getCurrentHour() + 
":" + timePicker.getCurrentMinute(), 
Toast.LENGTH SHORT).show(); 


} 

(2) 按 F11 SE Android 模拟 器 中 调试 应 用 程序 。 
当 活 动 被 加 载 时 ， 可 以 看 到 TimePicker 显示 在 一 个 对 话 
框 窗口 内 (如 图 4-14 所 示 )。 设置 一 个 时 间 , 然后 单 击 Set 
按钮 ， 将 看 到 Toast 窗口 显示 了 您 刚刚 设置 好 的 时 间 。 

示例 说 明 

为 了 显示 一 个 对 话 杠 窗口 ， 可 以 使 用 showDialog() 
方法 ， 传 入 一 个 ID 来 标识 对 话 框 的 源 : 


showDialog(TIME DIALOG ID); 


Set time 


Cancel 
当 调 用 showDialog() FEIN, onCreateDialog() 77 1X: 
将 被 调用 : 
QOverride 


protected Dialog onCreateDialog(int id) E] 4-14 
{ 


switch (id) { 
case TIME DIALOG ID: 
return new TimePickerDialog( 
this, mTimeSetListener, hour, minute, false); 
] 
return null; 


} 


这 里 ， 创 建 了 一 个 TimePickerDialog 类 的 新 实例 ， 给 它 传 递 了 当前 上 下 文 、 回 调 函 数 、 
初始 的 小 时 和 分 钟 ， 以 及 TimePicker #2 77 EA 24 小 时 格式 显示 。 
当 用 户 单 击 TimePicker 对 话 框 窗口 中 的 Set 按钮 时 ， 将 调用 onTimeSetO 方 法 : 


private TimePickerDialog.OnTimeSetListener mTimeSetListener = 
new TimePickerDialog.OnTimeSetListener () 
{ 
public void onTimeSet ( 
TimePicker view, int hourOfDay, int minuteOfHour) 
{ 
hour = hourOfDay; 
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minute = minuteOfHour; 


SimpleDateFormat timeFormat = new SimpleDateFormat ("hh:mm aa") ; 
Date date = new Date(0,0,0, hour, minute); 
String strDate = timeFormat.format (date); 


Toast.makeText (getBaseContext(), 


"You have selected " + strDate, 
Toast.LENGTH SHORT).show(); 


Fi 


这 里 ,onTimeSet0 方 法 将 包含 用 户 分 别 通 过 hourOfDay 和 minuteOfHour 参数 设置 的 小 


时 和 分 钟 。 


4.2.2 DatePicker 视图 


与 TimePicker 类 似 的 另外 一 种 视图 就 是 DatePicker。 利 用 DatePicker， 可 以 使 用 户 在 


活动 中 选择 一 个 特定 的 日 期 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 使 用 DatePicker. 


使 用 DatePicker 视图 
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(1) 使 用 前 述 “ 试 一 试 ” 中 创建 的 BasicViews4 项 目 ， 按 如 下 所 示人 修改 main.xml X fF: 


<?xml version-"1.0" encoding-"utfí-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button android:id="@+id/btnSet" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"I am all set!" 
android:onClick-"onClick" /» 


«DatePicker android:id="@+id/datePicker" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


<TimePicker android:id="@+id/timePicker" 
android: layout width="wrap content" 


android:layout height="wrap content" /> 


</LinearLayout> 


(2) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 图 4-15 显示 了 DatePicker 视图 (需要 


按 Ctrl+F11 组 合 键 将 模拟 器 的 方 问 改 为 横 问 ;， 纵 问 太 罕 ， 不 能 很 好 地 显示 DatePicker). 
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_ 
8^ 5554:Andrcid 4.0 E 一 一 


P BasicViews4 


| am all set! 


1 2 3 
feo | 10 
11 12 13 14 15 16 17 
18 19 20 21 22 23 24 


25 26 2/ 28 29 30 31 


图 4-15 


(3) 返回 Eclipse, ft BasicViews4Activity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


packag 


import 
import 


import 
import 
import 
import 
import 
import 
import 
import 


public 
Ti 


e net.learn2develop.BasicViews4; 


java.text.SimpleDateFormat; 
java.util.Date; 


android.app.Activity; 
android.app.Dialog; 
android.app.TimePickerDialog; 
android.os.Bundle; 
android.view.View; 
android.widget.DatePicker; 
android.widget.TimePicker; 
android.widget.Toast; 


class BasicViews4Activity extends Activity [ 
mePicker timePicker; 


DatePicker datePicker; 


int hour, minute; 
static final int TIME DIALOG ID = 0; 


/* 


* Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
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timePicker = (TimePicker) findViewById(R.id.timePicker); 
timePicker.setIs24HourView (true) ; 


// showDialog(TIME DIALOG ID); 
datePicker = (DatePicker) findViewById(R.id.datePicker); 


@Override 
protected Dialog onCreateDialog(int id) 
{ 

switch (id) { 

case TIME DIALOG ID: 

return new TimePickerDialog( 
this, mTimeSetListener, hour, minute, false); 
} 


return null; 


private TimePickerDialog.OnTimeSetListener mTimeSetListener = 
new TimePickerDialog.OnTimeSetListener () 
{ 
public void onTimeSet ( 
TimePicker view, int hourOfDay, int minuteOfHour) 


hour - hourOfDay; 
minute = minuteOfHour; 


SimpleDateFormat timeFormat = new SimpleDateFormat ("hh:mm aa"); 
Date date = new Date(0,0,0, hour, minute); 
String strDate = timeFormat.format (date); 


Toast.makeText (getBaseContext(), 
"You have selected " + strDate, 
Toast.LENGTH SHORT).show(); 


public void onClick(View view) | 
Toast.makeText(getBaseContext(), 

"Date selected:" + (datePicker.getMonth() + 1) + 
"/" + datePicker.getDayOfMonth() + 
"/" + datePicker.getYear() + "\n" + 
"Time selected:" + timePicker.getCurrentHour() + 
ms" + timePicker.getCurrentMinute(), 
Toast.LENGTH SHORT) .show() ; 


(4) 按 F11 $E Android RMAs Liye. A SA, il; Button 将 显 


第 4 章 使 用 视图 设计 用 局 界面 


Iia MHH, nl 4-16 所 示 。 
| EA 5554:Android. 4.0 EXE 


" BasicViews4 


| am all set! 


7 
Date selected:12/10/2011 
Time selected:6:40 > 13 14 


= 


18 19 20 21 


25 26 2f 28 


图 4-16 
示例 说 明 
与 TimePicker 类 似 ， 通 过 调用 getMonthO 、getDayOfMonthO0 和 getYear0 方 法 来 分 别 获 
取 月 份 、 日 子 和 年 份 : 
"Date selected:" + (datePicker.getMonth() + 1) + 
"/" + datePicker.getDayOfMonth() + 
"/" + datePicker.getYear() + "An" + 
注意 ，getMonth0 方 法 返回 0 代表 一 月 、 返 回 1 代表 二 月 ， 依 次 类 推 。 因 此 ， 需 要 将 
此 方法 返回 的 结果 加 1 来 获得 对 应 的 月 份 数 。 
f& TimePicker 一 样 ， 也 可 以 在 对 话 框 窗口 中 显示 DatePicker. FIA “ik ik” AL 
您 如 何 做 到 这 一 点 。 
试 一 试 使 用 对 话 框 显示 DatePicker 视图 
(1) 使 用 前 述 “ 试 一 试 ” 中 创建 的 BasicViews4 项 目 ， 在 BasicViews4Activity java 文件 
中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.BasicViews4; 
import java.text.SimpleDateFormat; 
import java.util.Calendar; 

import java.util.Date; 


import android.app.Activity; 
import android.app.DatePickerDialog; 
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import android.app.Dialog; 

import android.app.TimePickerDialog; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.DatePicker; 
import android.widget.TimePicker; 
import android.widget.Toast; 


public class BasicViews4Activity extends Activity I 
TimePicker timePicker; 
DatePicker datePicker; 


int hour, minute; 
int yr, month, day; 


0; 
l; 


static final int TIME DIALOG ID 
static final int DATE DIALOG ID 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


timePicker = (TimePicker) findViewById(R.id.timePicker); 
timePicker.setIs24HourView (true) ; 


// showDialog(TIME DIALOG ID); 
datePicker = (DatePicker) findViewById(R.id.datePicker); 


//---get the current date--- 

Calendar today = Calendar.getInstance(); 
yr = today.get(Calendar.YEAR); 

month = today.get(Calendar.MONTH); 

day = today.get(Calendar.DAY OF MONTH); 


showDialog(DATE DIALOG ID); 


@Override 
protected Dialog onCreateDialog(int id) 
{ 
switch (id) { 
case TIME DIALOG ID: 
return new TimePickerDialog ( 
this, mTimeSetListener, hour, minute, false); 
case DATE DIALOG ID: 
return new DatePickerDialog( 
this, mDateSetListener, yr, month, day); 
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return null; 


private DatePickerDialog.OnDateSetListener mDateSetListener = 
new DatePickerDialog.OnDateSetListener () 
{ 
public void onDateSet ( 
DatePicker view, int year, int monthOfYear, int dayOfMonth) 


yr = year; 
month = monthOfYear; 
day = dayOfMonth; 
Toast. makeText (getBaseContext(), 
"You have selected : " + (month + 1) + 
"/" + day + "/" + year, 
Toast.LENGTH SHORT) . show () ; 


private TimePickerDialog.OnTimeSetListener mTimeSetListener = 
new TimePickerDialog.OnTimeSetListener () 
{ 
public void onTimeSet ( 
TimePicker view, int hourOfDay, int minuteOfHour) 


hour = hourOfDay; 
minute = minuteOfHour; 


simpleDateFormat timeFormat = new SimpleDateFormat ("hh:mm aa") ; 
Date date - new Date(0,0,0, hour, minute); 
String strDate = timeFormat.format (date); 


Toast.makeText(getBaseContext(), 
"You have selected " + strDate, 
Toast.LENGTH SHORT).show(); 


public void onClick(View view) | 
Toast.makeText (getBaseContext (), 

"Date selected:" + (datePicker.getMonth() + 1) + 
"/" + datePicker.getDayOfMonth() + 
"/" + datePicker.getYear() + "Mn" + 
"Time selected:" + timePicker.getCurrentHour() + 
":" + timePicker.getCurrentMinute(), 
Toast.LENGTH SHORT).show(); 


} 
(2) {> F11 Æ Android 模拟 器 上 调试 应 用 程序 。 当 活动 加 载 时 ， 可 以 看 到 DatePicker 
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显示 在 一 个 对 话 框 窗口 中 (如 图 4-17 所 示 )。 设 定好 一 个 日 期 并 单 击 Set 按钮 。Toast 窗口 将 
显示 出 您 刚刚 设置 好 的 日 期 。 
f 5554:Android 4.0 EE aa 


Set date 


Cancel 


图 4-17 
示例 说 明 
DatePicker 和 TimePicker 的 工作 原理 是 一 致 的 。 当 设置 日 期 时 ， 它 将 外 
方法 ， 从 中 可 以 获取 由 用 户 设 定 的 日 期 ; 


public void onDateSet ( 


1 发 onDateSet() 


DatePicker view, int year, int monthOfYear, int dayOfMonth) 


{ 
yr = year; 
month = monthOfYear; 
day = dayOfMonth; 
Toast .makeText (getBaseContext (), 
"You have selected : " + (month + 1) + 
"I" + day + "JI" + year, 
Toast.LENGTH SHORT) .show(); 
} 


注意 ， 在 显示 对 话 框 之 前 ， 需 要 初始 化 3 个 变量 一 一 yr、month 和 day: 


//---get the current date--- 

Calendar today - Calendar.getInstance(); 
yr = today.get (Calendar.YEAR); 

month = today.get(Calendar.MONTH); 

day = today.get(Calendar.DAY OF MONTH); 


showDialog (DATE DIALOG ID); 
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如 果 不 这 样 做 ， 当 在 运行 时 创建 一 个 DatePickerDialog 类 的 实例 时 ， 将 发 生 非 法 参数 
f$ (current should be >= start and <= end). 


4.3 使 用 列表 视图 显示 长 列表 


列表 视图 是 一 种 可 以 用 来 显示 长 的 项 列表 的 视图 。 在 Android 中 ， 有 两 种 列表 视图 : 
ListView 和 SpinnerView， 两 者 都 用 于 显示 长 的 项 列表 。 下 面 的 “ 试 一 试 ” 展 示 了 这 两 种 视 
图 的 使 用 。 


4.3.1 ListView 视图 


ListView 在 一 个 垂直 滚动 列表 中 显示 项 列表 。 下 面 的 “ 试 一 试 ” 演 示 了 如 何 使 用 
ListView 显示 一 个 项 列表 。 


使 用 ListView 显示 一 个 长 的 项 列表 


BasicViews5.zip fCfZ X ff A LIE Wrox.com £ FE 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews5 的 Android Ju H . 
(2) 修改 BasicViewsSActivity.java 文件 ， 插 入 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.BasicViews5; 


import android.app.ListActivity; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.ArrayAdapter ; 
import android.widget.ListView; 
import android.widget.Toast; 


public class BasicViews5Activity extends ListActivity { 

String[] presidents = { 
"Dwight D. Eisenhower", 
"John F. Kennedy", 
"Lyndon B. Johnson", 
"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 

}; 


/** Called when the activity is first created. */ 
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QOverride 


public void onCreate (Bundle savedInstanceState) { 


super. onCreate (savedinstanceState) ; 


//---no need to call this--- 
/ / setContentView (R.layout.main); 


setListAdapter(new ArrayAdapter<String>(this, 
android.R.layout.simple list item 1, presidents)); 


public void onListItemClick ( 


ListView parent, View v, int position, long id) 
i 
Toast.makeText(this, 
"You have selected " + presidents[position], 
Toast.LENGTH SHORT).show(); 


) 


(3) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 
图 4-18 HEN T ERARA 子 列表 的 活动 。 

(4) 单 击 一 个 列表 项 ， 将 显示 一 个 包含 所 选择 项 的 
iH. 

示例 说 明 

在 本 例 中 ， 首 先 要 注意 的 是 BasicViews5Activity 类 
扩展 了 ListActivity 类 。 ListActivity 类 扩展 了 Activity 类 
并 且 通 过 绑 定 到 一 个 数据 源 来 显示 一 个 项 列表 。 还 要 注 


意 , 无须 修改 main.xml WRES ListView; ListActivity 


类 本 身 己 经 包 售 了 一 个 ListView。 因 此 ， 在 onCreate() 
方法 中 , 不 需要 调用 setContentView0O 方 法 来 从 main.xml 
文件 中 加 载 用 户 界 面 : 


//---no need to call this--- 
//setContentView(R.layout.main) ; 


e BasicViews5 


Dwight D. Eisenhower 
John F. Kennedy 
Lyndon B. Johnson 
Richard Nixon 

Gerald Ford 

Jimmy Carter 

Ronald Reagan 
George H. W. Bush 
Bill Clinton 


F " tae m] "| 


图 4-18 


在 onCreate0 方 法 中 ， 使 用 setListAdapterO 方 法 来 用 一 个 ListView 以 编程 方式 填充 活 
动 的 整个 屏幕 。ArrayAdapter 对 象 管理 将 由 ListView 显示 的 字符 串 数组 ,在 前 面 的 例子 中 ， 


将 ListView 设置 为 在 simple list item 1 模式 下 显示 : 


setListAdapter (new ArrayAdapter<String> (this, 


android.R.layout.simple list item 1, presidents)); 


当 单 击 ListView 中 的 一 个 列表 项 时 ， 将 触发 onListItemClick0 方 法 : 


public void onListItemClick( 
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ListView parent, View v, int position, long id) 


{ 
Toast.makeText (this, 
"You have selected " + presidents [position], 
Toast.LENGTH SHORT).show(); 
} 


这 里 ， 只 是 使 用 Toast 类 来 显示 所 选择 的 总 统 名 字 。 
定制 ListView 


ListView 是 一 个 可 以 进一步 定制 的 通用 视图 。 下 和 面 的 “ 试 一 试 ” 展 示 了 如 何 允许 在 
ListView 中 选择 多 个 项 以 及 如 何 使 之 文 持 簿 选 功能 。 
在 ListView 中 启用 对 筛选 和 多 列表 项 的 支持 
(1) 打开 前 一 节 中 创建 的 BasicViews5 项 目 , 在 BasicViewsSActivity.java 文件 中 添加 下 
列 粗 体 显示 的 语句 : 
/** Called when the activity is first created. */ 


@Override 
public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 


//---no need to call this--- 
/ /setContentView (R.layout.main); 


ListView lstView - getListView(); 
//1stView.setChoiceMode (ListView.CHOICE MODE NONE); 
//lstView.setChoiceMode (ListView.CHOICE MODE SINGLE); 
lstView.setChoiceMode (ListView.CHOICE MODE MULTIPLE); 
lstView.setTextFilterEnabled(true); 


setListAdapter (new ArrayAdapter<String> (this, 
android.R.layout.simple list item checked, presidents) ); 
} 

(2) 按 F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 现 在 ， 可 以 单 击 每 个 项 以 显示 其 旁 
边 的 色 写 图 标 (如 图 4-19 所 示 )。 

示例 襄 明 

为 了 以 编程 方式 获得 对 ListView 对 象 的 引用 ， 可 以 使 用 能 获取 ListActivity 的 列表 视 
图 的 getListView0 方 法 。 想 要 以 编程 方式 修改 ListView 的 行为 ， 就 需要 这 么 做 。 在 此 情况 
下 ， 使 用 setChoiceModeO) 方 法 来 告诉 ListView 如 何 处 理 一 个 用 户 的 单 击 。 在 本 例 中 ， 将 其 
设置 为 ListView.CHOICE MODE MULTIPLE， 这 意味 着 用 户 可 以 选择 多 个 项 : 


ListView lstView = getListView(); 
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//lstView.setChoiceMode (ListView.CHOIC 
E MODE NONE) ; 

//lstView.setChoiceMode (ListView.CHOIC 
E MODE SINGLE); 
lstView.setChoiceMode(ListView.CHOICE 
MODE MULTIPLE); 


ListView H dE? ES B Bee S dE Rp IE. Unie setTextFilterEnabled()7; 3X; JH S 
中 选 功 能 ， 用 户 将 可 以 在 键盘 上 输入 并 且 ListView 将 目 动 贤 选 来 匹配 已 经 输入 的 内 容 : 
lstView.setTextFilterEnabled (true) ; 
图 4-20 显示 了 起 作用 的 列表 筛选 功能 。 这 里 ， 列 表 中 所 有 包含 单词 john 的 项 将 在 结 
果 列 表 中 显示 出 来 。 


F r 
8» Sa3dAndroid 40 8» s333^Andraid A0 


p BasicViews5 p BasicViews5 


Dwight D. Eisenhower John F. Kennedy 


John F. Kennedy Lyndon B. Johnson 
Lyndon B. Johnson 

Richard Nixon 

Gerald Ford 

Jimmy Carter 

Ronald Reagan 

GeO! You have selected Jimmy Carter v 
Bill Clinton 


£F ae itr Ma 2 | 


图 4-19 4-20 


虽然 本 例 中 显示 了 总 统 名 字 列表 存储 在 一 个 数组 中 ， 但 在 实际 的 应 用 中 ， 建 议 从 数据 
库 中 检索 它们 或 至 少将 它们 存储 在 strings xml 文件 中 。 下 面 的 “ 试 一 试 ”展示 了 这 一 点 。 


将 列表 项 存储 在 strings.xml 文件 中 
(1) 使 用 前 一 节 创 建 的 BasicViewss 项 目 ， 在 位 于 res/values 文件 夹 下 的 strings.xml X: 
件 中 添加 下 列 粗 体 显示 的 行 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<resources> 
«string name="hello">Hello World, BasicViews5Activity!</string> 
«string name-"app name">BasicViews5</string> 
<string-array name-"presidents array"> 
<item>Dwight D. Eisenhower</item> 
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<item>John F. Kennedy</item> 
<item>Lyndon B. Johnson</item> 
<item>Richard Nixon</item> 
<item>Gerald Ford</item> 
<item>Jimmy Carter</item> 
<item>Ronald Reagan</item> 
<item>George H. W. Bush</item> 
<item>Bill Clinton</item> 
<item>George W. Bush</item> 
<item>Barack Obama</item> 


</string-array> 


</resources> 


(2) 按 下 列 粗 体 显 示 内 容 修 改 BasicViews5Activity.java 文件 : 


public class BasicViewsb5bActivity extends ListActivity { 


String[] presidents; 


/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


//---no need to call this--- 
//setContentView(R.layout.main); 


ListView lstView = getListView(); 
//lstView.setChoiceMode (ListView.CHOICE MODE NONE); 
//lstView.setChoiceMode (ListView.CHOICE MODE SINGLE); 
lstView.setChoiceMode (ListView.CHOICE MODE MULTIPLE); 
lstView.setTextFilterEnabled(true); 


presidents - 


getResources().getStringArray (R.array.presidents array); 


setListAdapter (new ArrayAdapter<String> (this, 


android.R.layout.simple list item checked, presidents)); 


public void onListItemClick ( 
ListView parent, View v, int position, long id) 


{ 


(3) 4% F11 键 在 Android 模拟 需 上 调试 应 用 程序 。 您 将 会 看 到 同 前 面 的 “ 试 


Toast.makeText (this, 
"You have selected ”+ presidents[position], 
Toast.LENGTH SHORT).show(); 
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- 样 的 名 字 列 表 。 
zn Dii BH 
由 于 现在 名 字 存 储 在 strings.xml 文件 中 ， 所 以 可 以 在 这 个 BasicViewsSActivity.java X 
件 中 使 用 getResources0 方 法 以 编程 方式 来 检索 它 : 


presidents = 
getResources().getStringArray(R.array.presidents array); 


- 般 地 ， 可 以 使 用 getResources0 方 法 以 编程 方式 来 检索 与 应 用 程序 捆绑 的 资源 。 
这 个 示例 演示 了 如 何 使 ListView 中 的 列表 项 可 被 选择 。 在 选择 过 程 的 结尾 ， 如 何 知道 
哪个 项 或 哪些 项 被 选中 ?下 面 的 “ 试 一 试 ” 演 示 了 有 具体 做 法 。 
—— 
(1) 再 次 使 用 BasicView5 项 目 ， 在 main.xml 文件 中 添加 下 列 粗 体 显示 的 代码 : 


<?xml version="1.0" encoding-"utfí-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btn" 
android: layout width="fill parent" 
android: layout height-"wrap content" 
android: text="Show selected items" 
android: onClick="onClick"/> 


<ListView 
android: id="@+id/android:list" 
android: layout width="wrap content" 
android: layout height-"wrap content" /? 


</LinearLayout> 

(2) 在 BasicViews5Activity.java 文件 中 添加 下 列 粗 体 显示 的 代码 : 
package net.learn2develop.BasicViews5; 

import android.app.ListActivity; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.ArrayAdapter; 

import android.widget.ListView; 


import android.widget.Toast; 


public class BasicViewsSActivity extends ListActivity { 
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String[] presidents; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


ListView lstView = getListView(); 
//lstView.setChoiceMode (ListView.CHOICE MODE NONE); 
//lstView.setChoiceMode (ListView.CHOICE MODE SINGLE); 
lstView.setChoiceMode (ListView.CHOICE MODE MULTIPLE); 
lstView.setTextFilterEnabled(true); 


presidents = 
getResources().getStringArray(R.array.presidents array); 


setListAdapter (new ArrayAdapter<String> (this, 
android.R.layout.simple list item checked, presidents) ); 


public void onListItemClick( 
ListView parent, View v, int position, long id) 
{ 
Toast.makeText (this, 
"You have selected ”+ presidents[position], 
Toast.LENGTH SHORT) .show(); 


public void onClick(View view) { 
ListView lstView = getListView(); 


String itemsSelected = "Selected items: \n"; 
for (int i=0; i<lstView.getCount(); i++) { 


if (lstView.isItemChecked(i)) { 
itemsSelected += lstView.getItemAtPosition(i) + "Mn"; 


) 


Toast.makeText(this, itemsSelected, Toast.LENGTH LONG).show(); 


} 


(3) 按 F11 键 在 Android 模拟 嚣 上 调试 应 用 程序 。 单 击 一 些 列表 项 ， 然 后 单 击 Show 
selected items 按钮 ， 如 图 4-21 所 示 。 所 选 名 字 的 列表 将 会 显示 出 来 。 
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" 
»  553d;4ndroid 40 


P BasicViews5 


Show selected items 
Dwight D. Eisenhower y” 
John F. Kennedy 
Lyndon B. Johnson 
Richard Nixon w” 


Gerald Ford 


Selected items: 
Dwight D. Eisenhower 
Richard Nixon 

George H. W. Bush 


Jimmy ( 
Ronald 上 


George H. W. Bush w” 


mll Afiat ann 


图 4-21 


示例 说 明 
在 前 一 节 的 练习 中 ， 看 到 了 如 何 填充 一 个 占据 整个 活动 的 ListView 一 一 在 该 例 中 ， 不 
i; [n] main.xml 文件 添加 一 个 <ListView> 元 素 。 在 本 例 中 ,看 到 了 ListView 可 以 部 分 填充 
个 活动 。 为 此 ， 需 要 添加 一 个 <ListView> 元 素 ， 并 将 其 id 属性 设 为 @+idiandroid:list: 
<ListView 
android: id="@+id/android:list" 


android:layout width="wrap content" 
android:layout height="wrap content" /> 


然后 需要 使 用 setContentView() 77 32: JU 2353685 NY A AZ ECS): 


setContentView (R. layout.main) ; 


为 了 找 出 ListView 中 哪些 项 被 选中 ， 使 用 了 isItemChecked0 方 法 : 


ListView lstView = getListView(); 
String itemsSelected = “Selected items: \n"; 
for (int i-0; i<lstView.getCount(); i++) { 
if (lstView.islItemChecked(i)) { 
itemsSelected += lstView.getItemAtPosition(i) + "Wn"; 


} 
Toast.makeText (this, itemsSelected, Toast.LENGTH LONG) .show(); 


getItemAtPosition0 方 法 返回 了 指定 位 置 的 列表 项 的 名 称 。 
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À 注意 : 到 目前 为 止 ， 所 有 的 例子 都 显示 了 如 何在 一 个 ListActivity 内 使 用 
ListView。 这 不 是 绝对 必要 的 一 一 您 也 可 以 在 Activity 内 使 用 ListView。 在 本 
例 中 ， 为 了 以 编程 方式 引用 ListView， 使 用 了 findViewByIDO 方 法 而 不 是 
getListView() Z ik . <ListView> 元 率 的 id 属性 可 以 使 用 这 种 格式 : 


@-+id/<view_name>. 


4.3.2 使 用 Spinner 视图 
ListView 在 一 个 活动 中 显示 一 个 长 的 项 列表 , 但 有 时 需要 在 用 户 界 面 上 显示 其 他 视图 ， 
因此 没有 额外 的 空间 来 显示 像 ListView 这 样 的 全 屏 视 图 。 在 这 种 情况 下 ， 应 该 使 用 
SpinnerView。SpinnerView 一 次 显示 列表 中 的 一 项 ， 并 可 以 使 用 户 在 其 中 进行 选择 。 
下 面 的 “ 试 一 试 ” 展 示 了 如 何在 活动 中 使 用 SpinnerView。 
i — iX 使 用 SpinnerView 一 次 显示 一 个 项 


BasicViews6.zip 1CHI X fF ATLA LE Wrox.com E F 


(1) 打开 Eclipse， 创 建 一 个 名 为 BasicViews6 的 Android 项 目 。 
(2) 按 如 下 所 示 修 改 位 于 res/layout 文件 夹 下 的 main.xml 文件 : 


<?xml version-"1.0" encoding-"utí-8"?-» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Spinner 
android: id="@+tid/spinner1" 
android: layout width-"wrap content" 
android: layout height="wrap content" 
android: drawSelectorOnTop="true" /> 


</LinearLayout> 


(3) 把 下 列 粗 体 显 示 的 行 添加 到 位 于 res/values 文件 夹 下 的 strings.xml 文件 中 ; 


<?xml version-"1.0" encoding-"utí-8"?» 
<resources> 
«string name="hello">Hello World, BasicViewséActivity!</string> 
<string name="app name">BasicViews6</string> 
<string-array name="presidents array"> 
<item>Dwight D. Eisenhower</item> 
<item>John F. Kennedy</item> 
<item>Lyndon B. Johnson</item> 
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<item>Richard Nixon</item> 
<item>Gerald Ford</item> 
<item>Jimmy Carter</item> 
<item>Ronald Reagan</item> 
<item>George H. W. Bush</item> 
<item>Bill Clinton</item> 
<item>George W. Bush</item> 
<item>Barack Obama</item> 
</string-array> 
</resources> 


(4) 在 BasicViews6Activityjava 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.BasicViews6; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.widget.AdapterView; 

import android.widget.AdapterView.OnItemSelectedListener; 
import android.widget.ArrayAdapter; 

import android.widget.Spinner; 

import android.widget.Toast; 


public class BasicViewsóActivity extends Activity I 
String[] presidents; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView(R.layout.main); 


presidents - 
getResources () .getStringArray (R.array.presidents array); 
Spinner s1 = (Spinner) findViewById(R.id.spinner1); 


ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, 
android.R.layout.simple spinner item, presidents); 


s1.setAdapter (adapter) ; 
si1.setOnItemSelectedListener (new OnItemSelectedListener () 
{ 
QOverride 
public void onlItemSelected(AdapterView«?» argO0, 
View argl, int arg2, long arg3) 
{ 
int index = argO.getSelectedItemPosition(); 
Toast.makeText(getBaseContext(), 
"You have selected item : " + presidents[index], 
Toast.LENGTH SHORT).show(); 
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} 


@Override 
public void onNothingSelected (AdapterView<?> arg0) { } 
); 
} 


(5) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 单 击 igen View 可 以 看 到 弹出 
个 显示 总 统 名 字 的 列表 (如 图 4-22 所 示 )。 单 击 一 个 列表 项 将 显示 一 个 消息 ， 表 明 这 个 列表 
项 被 选择 了 。 


Ii 5554 Android A 


" BasicViews6 


Jimmy Carter 


Dwight D. Eisenhower 
John F. Kennedy 
Lyndon B. Johnson 
Richard Nixon 
Gerald Ford 

Jimmy Garter 
Ronald Reagan 
George H. W. Bush 
Bill Clinton 

George W. Bush 
Barack Obama 


图 4-22 
示例 说 明 
上 面 的 例子 与 ListView 的 工作 原理 很 相像 。 需 要 实现 的 一 个 额外 方法 是 
onNothingSelected0 方 法 。 当 用 户 按 » Back 按钮 时 触发 这 一 方法 ， 撤 销 所 显示 的 项 列表 。 
在 这 种 情况 下 ， 没 有 任何 项 被 选择 ， 也 不 需要 作 任 何 处 理 。 
除了 在 ArrayAdapter 中 以 普 MM 显示 列表 项 之 外 ， 还 可 以 使 用 单 选 按钮 来 显示 
它们 。 要 做 到 这 一 点 ， 需 要 修改 ArrayAdapter 类 的 构造 函数 中 的 第 二 个 参数 : 


ArrayAdapter<String> adapter = new ArrayAdapter<String> (this, 
android.R.layout.simple list item single choice, presidents); 


这 样 将 使 列表 项 以 单 选 按钮 列表 形式 显示 (如 图 4-23 所 示 )。 
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= 
8^ 5554 Android, 4. 


44 了 解 特殊 人 碎片 


p BasicViews6 


Ronald Reagan 


Richard Nixon 
Gerald Ford 
Jimmy Carter 
Ronald Reagan 
George H. W. Bush 
Bill Clinton 
George W. Bush 


Barack Obama 


图 4-23 


ER 238, FAT Android 3 中 引入 的 碎片 功能 。 使 用 碎片 时 ， 可 以 定制 Android 应 用 
程序 的 用 户 界 面 ， 通 过 动态 地 重新 排列 碎片 使 其 适应 活动 。 这 样 就 允许 建立 的 应 用 程序 在 
拥有 不 同 的 屏幕 尺寸 的 设备 上 运行 。 

正如 前 面 介 绍 过 的 ， 碎片 是 拥有 目 己 的 生命 周期 的 “ 微 活动 "。 为 创建 一 个 肆 片 ， 需 
要 一 个 扩展 Fragment 基 类 的 类 。 除了 Fragment 基 类 外 , 还 可 以 扩展 Fragment 基 类 的 其 他 

- 些 子 类 ， 以 创建 更 加 特殊 的 健 片 。 下 面 将 介绍 Fragment 的 3 个 子 类 : ListFragment、 
DialogFragment 以 及 PreferenceFragment. 


4.4.1 使 用 ListFragment 


个 列表 碎 上 就 是 一 个 包 会 ListView 的 人 肆 片 ， 它 显示 来 日 攻 个 数据 源 (例如 一 个 数组 或 

-个 Cursor) H Ae. WIZE POP, 因为 经 铅 需 要 用 一 个 碎片 包含 一 个 项 列表 ( 例 

如 一 个 RSS WEP AAA), Fl Sa — E ens ren EAI a. 7g Y BRE —T e A 
de, WA HE ListFragment JE. 

下 面 “ 试 一 试 ” 展 示 了 局 动 一 个 伴 片 表 的 方法 。 
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创建 并 使 用 一 个 列表 碎片 


ListFragmentExample.zip fCf X fF uf HTE wrox.com E F3 


(1) 利用 Eclipse 创建 一 个 Android 项 目 ， 并 将 其 命名 为 ListFragmentExample. 
(2) 按照 下 列 粗 体 显 示 的 代码 修改 main.xml 文件 。 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" > 


«fragment 
android: name="net.learn2develop.ListFragmentExample.Fragment1" 
android: id="@+id/fragment1" 
android: layout weight="0.5" 
android: layout width="0dp" 
android: layout height-"200dp" /> 


<fragment 
android: name="net.learn2develop.ListFragmentExample.Fragment1" 
android: id="@+id/fragment2" 
android: layout weight="0.5" 
android: layout width="0dp" 
android: layout height-"300dp" /> 


</LinearLayout> 


(3) 将 一 个 XML 文件 添加 到 res/layout 文件 夹 中 并 将 其 命名 为 fragment] xml. 
(4) 使 用 如 下 代码 填充 fragmentl.xml X fF: 


<?xml version-"1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«ListView 
android:id-"8id/android:list" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout weight="1" 
android:drawSelectorOnTop-"false"/» 
«/LinearLayout» 


(5) 将 一 个 Java Class 文件 添加 到 包 里 并 把 它 命 名 为 Fragmentl. 
(6) 使 用 如 下 代码 填充 Fragmentl.java 文件 : 


package net.learn2develop.ListFragmentExample; 
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import android.app.ListFragment; 
import android.os.Bundle; 

import android.view.LayoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 
import android.widget.ArrayAdapter; 
import android.widget.ListView; 
import android.widget.Toast; 


public class Fragmentl1 extends ListFragment I 

String[] presidents = { 
"Dwight D. Eisenhower", 
"John F. Kennedy", 
"Lyndon B. Johnson", 
"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 


t; 


@Override 
public View onCreateView(LayoutInflater inflater, 
ViewGroup container, Bundle savedInstanceState) { 
return inflater.inflate(R.layout.fragmentl1, container, false); 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setListAdapter (new ArrayAdapter<String>(getActivity(), 
android.R.layout.simple list item 1, presidents) ); 


public void onListItemClick (ListView parent, View v, 
int position, long id) 
i 
Toast.makeText(getActivity(), 
"You have selected " + presidents[position], 
Toast.LENGTH SHORT).show(); 


} 
(T) 按 F11 键 在 Android 模拟 器 上 调试 应 用 程序 ， 图 4-24 显示 两 个 列表 碎片 ， 它 们 显 
示 了 两 个 总 统 名 字 列 表 。 
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(8) 单 击 两 个 ListView 视图 中 的 任意 一 个 选项 ， 会 显示 相应 的 消息 ( 如 图 4-25 所 示 )。 


B^ S554Jndroxl 41 B S554: ndr 4 


" ListFragmentExample p ListFragmentExample 


Dwight D. Dwight D. Dwight D. Dwight D. 
Eisenhower Eisenhower Eisenhower Eisenhower 


John F. Kennedy John F. Kennedy John F. Kennedy John F. Kennedy 


Lyndon B. Lyndon B. Lyndon B. Lyndon B. 
Johnson Johnson Johnson Johnson 


Richard Nixon Richard Nixon Richard Nixon Richard Nixon 
Gerald Ford Gerald Ford 


Jimmy Carter Jimmy Carter 


You have selected John F. Kennedy 


4-24 图 4-25 


示例 说明 
通过 将 一 个 ListView 元 素 洪 加 给 人 碎片， 首先 为 该 肆 片 创建 了 一 个 XML 文件 : 


<?xml version-"1.0" encoding-"utfí-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«ListView 
android:id-"8id/android:list" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout weight="1" 
android:drawSelectorOnTop-"false"/» 
</LinearLayout> 


AAS fill TP Ae EY BE Java 类 必须 扩展 ListFragement JE: 
Pubic class Fragmentl extends ListFragment { 
} 
接 下 来 声明 一 个 数组 ， 用 于 包含 活动 中 的 总 统 名 字 列 表 : 
String[] presidents = { 
"Dwight D. Eisenhower", 


"John F. Kennedy", 
"Lyndon B. Johnson", 
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"Richard Nixon", 
"Gerald Ford", 
"Jimmy Carter", 
"Ronald Reagan", 
"George H. W. Bush", 
"Bill Clinton", 
"George W. Bush", 
"Barack Obama" 


be 


在 onCreate() (FH, JH] setListAdapter0 方 法 以 编程 方式 将 数组 的 内 容 填 充 到 
ListView. ArrayAdapter 对 象 管 理 将 被 ListView 显示 的 字符 串 数组 。 在 本 例 中 将 ListView 
WATE simple list item 1 模式 下 显示 。 


@Override 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 
setListAdapter (new ArrayAdapter<String>(getActivity(), 
android.R.layout.simple list item 1, presidents)); 


} 
每 当 单 击 ListView 的 一 个 列表 项 时 ， 就 会 触发 onListItemClickQ Wik: 


public void onListItemClick(ListView parent, View v, 
int position, long id) 


{ 
Toast.makeText (getActivity(), 
"You have selected ™ + presidents [position], 
Toast.LENGTH SHORT) .show(); 
} 


BO» ESAE TMS DBP, EECA A GS BE: 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" > 


«fragment 
android:name-"net.learn2develop.ListFragmentExample.Fragmentl" 
android:id="@tid/fragment1" 
android: layout weight="0.5" 
android: layout width="O0dp" 
android:layout height="200dp" /> 


<fragment 
android:name-"net.learn2develop.ListFragmentExample.Fragmentl" 
android: id="@tid/fragment2" 
android: layout weight="0.5" 
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android:layout width="0dp" 
android:layout height="300dp" /> 


</LinearLayout> 


4.4.2 ”使 用 DialogFragment 

AY eg ms Ey RAR ER WEM. OEE eo ela LO, FF AE 
态 方式 显示 。 当 需要 获得 用 户 的 啊 应 ， 然 后 才能 继续 执行 操作 的 时 候 ， 对 话 框 碎片 十 分 有 
用 。 为 了 创建 一 个 对 话 框 碎片 ， 震 要 扩展 DialogFragment 4%. 

PRAY “ik ik” eas TE EREE A TE. 


创建 并 使 用 一 个 对 话 碎片 


DialogFragmentExample.zip fCf X fF A UITE Wrox.com E FÆ 


(1) 使 用 Eclipse 创建 一 个 Android 项 目 ， 并 把 它 命 名 为 DialogFragmentExample. 
(2) 问 包 里 添加 一 个 Java 类 文件 并 将 其 命名 为 Fragment1l 。 
(3) 使 用 如 下 代码 填充 Fragmentl.java 文件 。 


package net.learn2develop.DialogFragmentExample; 


import android.app.AlertDialog; 

import android.app.Dialog; 

import android.app.DialogFragment; 
import android.content.DialogInterface; 
import android.os.Bundle; 


public class Fragmentl extends DialogFragment { 


static Fragmentl newInstance(String title) { 
Fragmentl1 fragment = new Fragmentl(); 
Bundle args = new Bundle(); 
args.putString("title", title); 
fragment.setArguments (args); 
return fragment; 


@Override 
public Dialog onCreateDialog(Bundle savedInstanceState) { 
String title = getArguments().getString("title") ; 
return new AlertDialog. Builder (getActivity () ) 
.setIcon(R.drawable.ic launcher) 
.setTitle(title) 
.setPositiveButton("OK", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) { 
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((DialogFragmentExampleActivity) 
getActivity()).doPositiveClick(); 


)) 
.setNegativeButton("Cancel", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) { 
((DialogFragmentExampleActivity) 
getActivity()).doNegativeClick(); 
} 


)).create(); 


} 
(4) 使 用 下 列 粗 体 显 示 的 代码 填充 DialogFragmentExampleActivity.java 文件 。 


package net.learn2develop.DialogFragmentExample; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 


public class DialogFragmentExampleActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


Fragmenti1 dialogFragment = Fragmentl.newInstance( 
"Are you sure you want to do this?"); 
dialogFragment.show(getFragmentManager(), "dialog"); 


public void doPositiveClick() { 
//---perform steps when user clicks on OK--- 
Log.d("DialogFragmentExample", "User clicks on OK"); 


public void doNegativeClick() { 
//---perform steps when user clicks on Cancel--- 
Log.d("DialogFragmentExample", "User clicks on Cancel"); 


} 
(5) FX F11 键 在 Android 模拟 需 上 调试 应 用 程序 。 图 4-26 Brzs ieee R US 


框 中 显示 。 单 击 OK 按钮 或 Cancel 按钮 ， 观 察 显示 的 消 明 。 
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示例 说 明 
为 创建 一 个 对 话 人 碎片 ， 首 先 Java 类 要 扩展 DialogFragment 基 类 : 


public class Fragmentl extends DialogFragment { 
} 


在 本 例 中 , 创建 了 一 个 警告 对 话 框 , 这 是 一 个 显示 一 条 消息 及 可 选 按钮 的 对 话 框 窗口 。 
在 Fragment] 类 中 ， 定 义 了 newlInstance0 方 法 : 


static Fragmentl newInstance(String title) { 
Fragmentl fragment = new Fragmenti (); 
Bundle args = new Bundle(); 
args.putstring("title", title); 
fragment.setArguments (args); 
return fragment; 


} 


newInstance(0 方 法 允许 创建 碎 卢 的 一 个 新 实例 ， 同 时 它 接 受 一 个 指定 警告 对 话 框 中 要 
显示 的 字符 串 (title) 的 参数 。title 随后 存储 在 一 个 Bundle 对 象 里 供 之 后 使 用 。 
接 下 来 定义 了 onCreateDialog0 方 法 ， 该 方法 在 onCreate0 之 后 、onCreateView0 之 前 调用 : 
QOverride 
public Dialog onCreateDialog(Bundle savedInstanceState) { 
String title = getArguments().getString("title"); 
return new AlertDialog.Builder(getActivity()) 
.setIcon(R.drawable.ic launcher) 
.setTitle(title) 
.SetPositiveButton("OK", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) { 
((DialogFragmentExampleActivity) 
getActivity()).doPositiveClick(); 


}) 
.setNegativeButton ("Cancel", 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, 
int whichButton) { 
((DialogFragmentExampleActivity) 
getActivity()).doNegativeClick(); 
} 


}) .create (); 


} 


在 这 里 ， 创 建 的 警告 对 话 框 有 两 个 按钮 ， OK 和 Cancel。 要 在 该 对 话 框 中 显示 的 字符 
串 从 保存 在 Bundle 对 象 中 的 title 参数 中 获取 。 
为 了 显示 对 话 框 碎片 ， 创 建 它 的 一 个 实例 并 调用 它 的 show0 方 法 : 


Fragmentl dialogFragment = Fragmentl.newInstance( 
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"Are you sure you want to do this?"); 
dialogFragment.show(getFragmentManager(), "dialog"); 
还 需要 实现 两 种 方法 : doPostiveClickO A doNegativeClick0， 分 别 用 于 处 理 用 户 单 击 
OK 按钮 或 Cancel 按钮 的 情况 。 
public void doPositiveClick() { 


//---perform steps when user clicks on OK--- 
Log.d("DialogFragmentExample", "User clicks on OK"); 


} 


public void doNegativeClick() { 
//---perform steps when user clicks on Cancel--- 
Log.d("DialogFragmentExample", "User clicks on Cancel"); 


} 
4.4.3 使 用 PreferenceFragment 


Android 应 用 程序 通 币 要 提供 首选 项 ， 以 允许 用 户 定制 应 用 程序 。 例 如 ， 可 以 允许 用 

户 保 存 那 些 用 于 访问 Web 资源 的 登录 凭据 ， 或 者 保存 源 刷 新 频率 的 信息 (比如 在 一 个 RSS 

阅读 堪 应 用 程序 中 ) 等 等 。 在 Android 中 ， 可 以 使 用 PreferenceActivity 基 类 为 用 户 显示 一 个 

用 于 编辑 首选 项 的 活动 。 在 Android 3.0 和 更 高 版 本 中 ， 可 以 使 用 PreferenceFragment 类 实 
现 相 同 的 功能 。 

下 面 “ 试 一 试 ” 显示 了 在 Android 3 和 Android 4 版 本 中 创建 并 使 用 一 个 首选 项 碎片 的 方法 。 


创建 并 使 用 一 个 首选 项 碎片 


PreferenceFragmentExample.zip IÇ X fF uf Ll f£ Wrox.com E FE 


4 È PreferenceFragmentExample 


(1) 使 用 Eclipse 创建 一 个 Android 项 目 并 把 它 命名 为 


PreferenceFragmentExample o a HE netlearnZdevelop.FreferenceFragmentExample 
5 [f| PreferenceFragmentExampleActivityjava 


(2) YE res 文件 夹 下 创建 一 个 新 的 xml 文件 夹 , 然后 将 || ， E gen eneste Fen 
-个 新 的 Android XML 文件 添加 到 该 xml 文件 夹 里 ,将 该 | Eee 
XML 文件 命名 为 preferences.xml( 如 图 4-27 所 示 )。 pe 


(3) 使 用 如 下 代码 填充 preferences.xml 文件 。 CORTE 


<?xml version="1.0" encoding-"utf-8"?» re 
X. preferences xml 
| AndroidManifest.xml 
B proguard.cfy 
B proje ct.properties 


«PreferenceScreen 


xmlns:android-"http://schemas.android.com/apk 4-27 
/res/android"> 


<PreferenceCategory android:title="Category 1"> 
<CheckBoxPreference 
android: title="Checkbox" 
android: defaultValue="false" 
android: summary="True of False" 
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android:key="checkboxPref" /> 
</PreferenceCategory> 


<PreferenceCategory android: title="Category 2"> 
<EditTextPreference 
android: name="EditText" 
android: summary="Enter a string" 
android: defaultValue="[Enter a string here]" 
android: title="Edit Text" 
android: key="editTextPref" /> 
<RingtonePreference 
android:name="Ringtone Preference" 
android: summary="Select a ringtone" 
android: title="Ringtones" 
android: key="ringtonePref" /> 
<PreferenceScreen 
android: title="Second Preference Screen" 
android: summary= 
"Click here to go to the second Preference Screen" 
android: key="secondPrefScreenPref"> 
<EditTextPreference 
android: name="EditText" 
android:summary="Enter a string" 
android: title="Edit Text (second Screen)" 
android:key-"secondEditTextPref" /> 
«/PreferenceScreen» 
«/PreferenceCategory» 


«/PreferenceScreen» 


(4) 将 一 个 Java 类 文件 添加 到 包 里 ， 并 将 其 命名 为 Fragmentl 。 
(5) 使 用 如 下 代码 填充 Fragmentl java 文件 。 


package net.learn2develop.PreferenceFragmentExample; 


import android.os.Bundle; 

import android.preference.PreferenceFragment; 

public class Fragmentl extends PreferenceFragment { 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savediInstanceState) ; 


//---load the preferences from an XML file--- 
addPreferencesFromResource (R.xml.preferences); 


} 
(6) 按照 下 列 粗 体 显 示 的 代码 修改 PreferenceFragmentExampleActivity.java 文件 。 
package net.learn2develop.PreferenceFragmentExample; 


import android.app.Activity; 
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import android.app.FragmentManager ; 
import android.app.FragmentTransaction; 
import android.os.Bundle; 


public class PreferenceFragmentExampleActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView(R.layout.main); 


FragmentManager fragmentManager = getFragmentManager () ; 

FragmentTransaction fragmentTransaction - 
fragmentManager.beginTransaction(); 

Fragmenti1 fragmenti = new Fragmentl(); 

fragmentTransaction.replace(android.R.id.content, fragmentl); 

fragmentTransaction.addToBackStack (null); 

fragmentTransaction.commit (); 


) 


(7) FX F11 键 在 Android 模拟 器 上 调试 应 用 程序 ， 图 4-28 JE SAU. "NER 
了 用 户 可 以 修改 的 首选 项 列表 。 

(8) 当 单 击 Edit Text 首选 项 时 ， 会 显示 一 个 弹出 窗口 (如 图 4-29 所 示 )。 

(9) 单 击 Second Preference Screen 选项 会 使 第 二 个 首选 项 屏 句 项 显示 出 来 (如 图 4-30 所 示 )。 


全 
F 
divin droid AD E Andro 4] nadmid 40 


& 5:09 El ü 5:10 
el PreferenceFragmentExample p Second Preference Screen 
Hellg ema pueterenceFragmentExamptleActivity! 


Edit Text (second Screen) 
Enter a string 

Checkbox J 

True of False 

CATEGORY 2 


Edit Text Edit Text 


Enter a string 


Ringtones [Enter a string here] 


Select a ringtone 


i Cancel 
Second Preference Screen 
Click here to go to the second Preference 


Screen 


图 4-28 图 4-29 图 4-30 


(10) 要 想 让 首选 项 碎片 消失 ， 在 模拟 器 上 单 击 Back 按钮 。 

(11) 如 果 查 看 File Explore( 在 DDMS 透视 图 中 可 用 )， 将 可 以 定位 到 位 于 /data/data/net. 
learn2develop.preferenceFragmentExample/shAred prefs/ 文 件 夹 中 的 首选 项 文件 (如 图 4-31 所 
示 )， 用 户 所 做 的 所 有 修改 都 保存 在 这 个 文件 中 。 
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u DDMS - PreferenceFragmentExample/src/net/leam2develon/PreferenceFraq mentExample/Fragment1 java - Eclipse 
File Edit Refactor Source Run Navigate Search Project Window Help 


: r*o- LI dg & ‘nae Bx #rorar 时 & lava ts Debug [£s nois |4% Java EE 


BOF- PAPEN 


me -p 


- Dr oe 


Fa "H Pu- oo Te T= l - "a 
@ Emulator Contr H Devices fi UM O [X Threads Heap Allocation Tracker ||: File Explorer t- 


. X|$ a G5 *| Oii [nome 


Mame 
E] emulatar-5554 


netleam2develop.PreferenceFragrmer | 


t CS netleamzdevelop.Metworking 
b [5 netleamidevelop Notifications 
p EC netleamsdevelop PassingData 


4 [> netleamidevelop PreferenceFragmentEexampie 
Bop lib 
4 (= shared prets 


| =| neblearnddevelop.PreterenceFragmentkxarmple_preferences oem 174 2011-12-10 1706 | 


»  netleamidevelop Senaces 

> > netleamddevelop Sockets 

> [S netleamédevelop. Threading 

> [A netleamZdevelop.Usinglnbent 

p [E netleamedevelop Using P references 
p [ER dontpanic 
p [e drm 
p [2 local 


4 n 


Tm LogCat | El Console rh 


SETTE Android 504 Contant Loader 


图 4-31 


注意 : 第 6 章 将 介绍 如 何 检索 保存 在 首选 项 文件 中 的 值 。 


示例 说 明 


为 了 在 Android 应 用 程序 中 创建 一 个 首选 项 的 列表 ， 首 先 需 要 创建 preferences xml 文 
件 并 将 不 同 的 XML 元 素 填充 到 该 文件 中 。 这 个 XML 文件 定义 了 各 种 想 保 存在 应 用 程序 中 


的 项 。 
为 了 创建 首选 项 碎片 ， 需 要 扩展 PreferenceFragment 基 类 : 


public class Fragmentl extends preferenceFragment{ 


} 


为 在 首选 项 人 肆 片 中 加 载 首 选项 文件 ， 可 以 使 用 addPreferencesFromResource() 77 77: 


QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


//---load the preferences from an XML file--- 
addPreferencesFromResource (R.xml.preferences); 


AEN a+ osx, «BY AEJ FragmentManger 类 和 FragmentTransaction 25: 


FragmentManager fragmentManager = getFragmentManager(); 

FragmentTransaction fragmentTransaction - 
fragmentManager.beginTransaction(); 

Fragmentl fragmentl = new Fragmentl(í(); 


fragmentTransaction.replace(android.R.id.content, fragmentl); 


fragmentTransaction.addToBackStack (null); 
fragmentTransaction.commit (); 


0206 
07:14 


0300 | 


0313 | 


n | 


Ell 


14:28| | 
1428 | 


zw BH| et El - F7 ^ H 
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需要 使 用 add ToBackStack() 77 72:5 T 326 30 f Fr 8 JH $] back stack， 从 而 用 户 可 以 通过 单 
击 Back 按钮 关闭 健 片 。 


45 ”本 章 小 结 
本 章 对 在 Android 应 用 程序 中 经 常会 用 到 的 一 些 视图 作 了 概述 。 虽 然 不 可 能 详细 研究 


每 一 个 视图 ， 但 这 里 所 学 习 到 的 视图 会 为 设计 Android 应 用 程序 的 用 户 界 面 提 供 一 个 良好 
的 基础 ， 而 不 用 管 其 需求 是 什么 。 


1. 如 何以 编程 方式 来 确定 一 个 RadioButton 是 否 被 选中 ? 

2. 如 何 访问 存储 在 strings.xml 文件 中 的 字符 串 资源 ? 

3. 写 一 段 代 码 来 获取 当前 日 期 。 

4. 列举 在 Android 应 用 程序 中 可 以 使 用 的 3 种 专用 雁 片 ， 并 描述 它们 的 用 法 。 
练习 答案 参见 附录 C. 


本 章 主要 内 容 
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<TextView 
android:layout width="fill parent" 
TextView android:layout height="wrap content" 
android:text="@ string/hello" 
/> 


«Button android:id="@+id/btnSave" 
android:layout width="fill parent" 
Button android:layout height="wrap content" 


android:text="Save™ /> 


«ImageButton android:id="@+id/btnImgl" 
android:layout width="fill parent" 
ImageButton android:layout height="wrap content" 


android:src="@drawable/icon™ /> 


<EditText android:id="@+id/txtName" 
EditText android:layout width="fill parent" 
android:layout height="wrap content" /> 


<CheckBox android:id="@+id/chkAutosave" 

android:layout width-"fill parent" 
CheckBox eee e Zw RD n en 
android:layout height-"wrap content 


android:text-"Autosave" /» 


RadioGroup 和 RadioButton 


ToggleButton 


ProgressBar 


AutoCompleteTextBox 


TimePicker 


DatePicker 


Spinner 


第 4 章 使 用 视图 设计 用 局 界面 


( 续 表 ) 


«RadioGroup android:id="@+id/rdbGp1" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:orientation-"vertical" > 
«RadioButton android:id="@+id/rdb1" 

android: layout width-"fill parent" 

android:layout height="wrap content" 

android:text="Option 1" /> 
<RadioButton android:id="@+id/rdb2" 

android:layout width="fill parent" 

android:layout height="wrap content" 

android:text="Option 2" /> 
</RadioGroup> 


<ToggleButton android: id="@+id/togglel" 
droid:layout width="wrap content" 


<ProgressBar android:id="@+id/progressbar" 
android: layout width="wrap content" 
android:layout height="wrap content" /> 


<AutoCompleteTextView 
android: id="@+id/txtCountries" 
android:layout width-"fill parent" 
android:layout height="wrap content" /> 


«TimePicker android:id="@+id/timePicker"™ 
android:layout width="wrap content" 
android:layout height="wrap content" /> 


<DatePicker android:id="@+id/datePicker" 
android:layout width="wrap content" 
android:layout height="wrap content" /> 


«Spinner android:id="@+id/spinnerl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:drawSelectorOnTop="true" /> 


ListFragment, DialogFragment, and PreferenceFragment 
android:src="@drawable/icon" /> 
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使 用 视图 显示 图 片 和 沫 单 


本 章 将 介绍 以 下 内 容 : 

e ”如何 使 用 Gallery. ImageSwitcher. GridView 和 ImageView 视图 显示 图 像 
e 如 何 显 示 选 项 菜单 和 上 下 文 菜单 

e 如 何 使 用 AnalogClock 和 DigitalClock 视图 显示 时 间 

e 如 何 使 用 WebView 显示 Web 内 容 


在 第 4 章 中 , 我 们 已 经 学 习 了 可 以 用 来 构建 Android 应 用 程序 的 用 户 界 面 的 不 同 视图 。 
本 章 将 继续 研究 其 他 可 用 来 创建 健壮 的 、 吸 引信 的 应 用 程序 的 视图 。 

特别 是 ， 我 们 会 将 注意 力 转 到 可 以 用 来 显示 图 像 的 视图 上 。 上 此外， 还 将 学 习 如 何在 
Android 应 用 程序 中 创建 选项 和 上 下 文 菜 单 。 本 章 结束 时 将 讨论 一 些 可 用 来 显示 当前 时 间 
和 Web 内 容 的 很 炫 酷 的 视图 。 


5.1 使 用 图 像 视 图 显示 图 片 


到 目前 为 止 ， 我 们 已 经 学 习 的 所 有 视图 都 是 用 来 显示 文本 信息 的 。 要 显示 图 像 ， 可 以 
使 用 ImageView、Gallery、ImageSwitcher 和 GridView 视图 。 

下 面 将 详细 介绍 每 一 个 视图 。 
5.1.1 Gallery #0 ImageView 视图 


Gallery 是 一 种 用 固定 在 中 间 位 置 的 水 平 滚动 列表 显示 列表 项 (如 图 像 ) 的 视图 。 图 5-1 
展示 了 Gallery 视图 在 显示 一 些 图 像 时 的 外 观 效 末 : 
下 和 面 的 “ 试 一 试 ”展示 了 如 何 使 用 Gallery 视图 显示 一 组 图 像 。 
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图 5-1 


使 用 Gallery 视图 


Gallery.zip (CAF X ff AT LL f£ Wrox.com E FÆ 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 将 其 命名 为 Gallery。 
(2) 按照 下 列 粗 体 显示 内 容 修改 main.xml X ff: 


<?xml version-"1.0" encoding-"utí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<TextView 
android: layout width-"fill parent" 
android:layout height="wrap content" 
android:text="Images of San Francisco" /> 


<Gallery 
android: id="@+id/galleryi" 
android: layout width="fill parent" 
android: layout height="wrap content" /> 


<ImageView 
android: id="@+id/image1" 
android: layout width="320dp" 
android: layout height="250dp" 
android: scaleType="fitxy" /> 


</LinearLayout> 


(3) 右 击 res/values WFR, WE New | File， 并 将 新 文件 命名 为 attrs.xml。 
(4) 在 attrs.xml 文件 中 输入 如 下 内 容 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<declare-styleable name="Gallery1"> 
<attr name="android:galleryItemBackground" /> 
</declare-styleable> 
</resources> 


(5) 准备 一 组 图 像 ， 并 将 每 一 张 图 像 依次 命名 为 picl.png. pic2.png $, WK 5-2 ita. 
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picb.png 


图 5-2 


注意 : 可 以 从 本 书 的 支持 网 站 www.wrox.com 上 下 载 这 组 图 像 。 


(6) 将 所 有 图 像 拖 放 到 res/drawable-mdpi 文件 夹 下 (如 图 5-3 所 示 )。 当 显示 一 个 对 话 框 
If, EP Copy files 选项 并 单 击 OK 按钮 。 


注意 :本 例 中 假设 这 一 项 目 将 在 具有 中 等 DPI 屏幕 分 辨 率 的 AVD 上 进行 测试 。 
在 实际 的 项 目 中 ， 需 要 确保 每 一 个 drawable 文件 夹 都 有 一 组 (不 同 分 辨 率 的 ) 
图 像 . 


à en Gallery 
b [E src 
b cm gen [Generated Java Files] 
> HBA Android 4.0 
[> assets 
> ge bin 
4 d res 
: (EE: drawable-hdpi 
^» EE drawable-ldp' 
4 (= drawable-mdpi 
B ic_launcher.png 
Be picl.png 
Pa pic2.png 
Me pic3.png 
|B& pict.png 
|B& pic5.png 
Ma pic6.png 
CS pic/.png 
4 (& layout 
(X; main.xml 


图 5-3 


(7) 在 GalleryActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 
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package net.learn2develop.Gallery; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.content.Context; 
android.content.res.TypedArray; 
android.os.Bundle; 
android.view.View; 
android.view.ViewGroup; 
android.widget.AdapterView; 
android.widget.AdapterView.OnItemClickListener; 
android.widget.BaseAdapter; 
android.widget.Gallery; 
android.widget.ImageView; 
android.widget.Toast; 


class GalleryActivity extends Activity | 


//---the images to display--- 


Integer[] imageIDs - ( 


d 


.drawable 
.drawable 
.drawable 
.drawable 
.drawable 
.drawable 
.drawable 


-picl, 
.pic2, 
.pic3, 
.pic4, 
.pic5, 
.picó6, 


JJ WJj gj mJ mj DJ mJ 


.pic7 


/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) | 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


Gallery gallery = (Gallery) findViewById(R.id.gallery1); 


gallery.setAdapter(new ImageAdapter (this)); 
gallery.setOnItemClickListener (new OnItemClickListener () 
{ 

public void onItemClick(AdapterView parent, View v, 


int position, long id) 
{ 
Toast.makeText (getBaseContext(), 
"pic" + (position + 1) + " selected", 
Toast.LENGTH SHORT) .show() ; 
} 


ERI 


public class ImageAdapter extends BaseAdapter 


{ 


Context context; 
int itemBackground; 


public ImageAdapter (Context c) 
i 

context = c; 

//---setting the style--- 
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TypedArray a = obtainStyledAttributes ( 
R.styleable.Gallery1); 

itemBackground = a.getResourceId( 

R.styleable.Galleryl android galleryItemBackground, 


0) ; 
a.recycle(); 


//---returns the number of images--- 


public int getCount() { 
return imageIDs.length; 


//---returns the item--- 
public Object getItem(int position) 
return position; 


//---returns the ID of an item--- 
public long getItemId(int position) 
return position; 


//---returns an ImageView view--- 


{ 


public View getView(int position, View convertView, 


ViewGroup parent) { 
ImageView imageView; 
if (convertView == null) { 


imageView = new ImageView (context) ; 
imageView.setImageResource (imageIDs[position]); 


imageView.setScaleType( 


ImageView.ScaleType.FIT XY); 


imageView.setLayoutParams( 


new Gallery.LayoutParams(150, 120)); 


} else { 


imageView — (ImageView) convertView; 


} 


imageView.setBackgroundResource (itemBackground) ; 


return imageView; 
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(8) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 图 5-4 展示 了 显示 一 系列 图 像 的 
Gallery 视图 。 可 以 轻 扫 图 像 来 显示 整个 系列 的 图 像 。 单 击 一 个 图 像 时 可 以 观察 到 Toast 类 
将 显示 图 像 名 称 。 


» 5554 Android d.( 


m Gallery 


Images af San Francisco 


pic5 selected 


图 5-4 


(9) 为 了 在 ImageView 中 显示 所 选 择 的 图 像 , 在 GalleryActivity.java XPFP ZAI P ZUR 


@Override 

public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 
setContentView (R.layout.main) ; 


Gallery gallery = (Gallery) findViewById(R.id.galleryl); 


gallery.setAdapter(new ImageAdapter (this)); 
gallery.setOnItemClickListener(new OnItemClickListener () 
1 

public void onlItemClick(AdapterView parent, View v, 

int position, long id) 

1 

Toast.makeText(getBaseContext (), 
"pic" + (position + 1) + " selected", 

Toast.LENGTH SHORT).show(); 


//---display the images selected--- 
ImageView imageView = 

(ImageView) findViewById(R.id.imagel); 
imageView.setImageResource (imageIDs [position] ) ; 
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} 


(11) 按 Fll 键 再 次 调试 应 用 程序 。 这 一 次 ， 将 会 看 到 在 ImageView 中 显示 了 所 选择 的 
图 像 (如 图 5-5 所 示 )。 


F 
1| S55¢4Andeid_ 40 


p Gallery 


Images of San Francisco 


示例 说 明 
首先 将 Gallery 和 ImageView 视图 添加 到 main.xml 文件 中 : 


«Gallery 
android:id="@+id/galleryl" 
android:layout width="fill parent" 
android:layout height="wrap content" /> 


<ImageView 
android:id="@+id/imagel" 
android: layout width="320dp" 
android:layout height="250dp" 
android:scaleType-"fitXY" /> 


正如 先前 所 述 ，Gallery 视图 用 来 在 一 个 水 平 滚动 列表 中 显示 一 系列 图 像 。ImageView 
用 来 显示 用 户 选 定 的 图 像 。 
需要 显示 的 图 像 列 表 存 储 在 imageIDs 数组 中 : 


//---the images to display--- 

Integer[] imageIDs = { 
R.drawable.picl, 
R.drawable.pic2, 
R.drawable.pic3, 
R.drawable.pic4, 
R.drawable.picd, 
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R.drawable.pic6, 
R.drawable.pic/ 
be 


创建 的 ImageAdapter 类 扩展 了 BaseAdapter 类 ， 可 以 用 来 将 一 系列 ImageView 视图 绑 
定 到 Gallery 视图 上 。BaseAdapter 类 作为 联系 AdapterView 和 为 它 提供 数据 的 数据 源 之 间 
的 桥 染 。 下 面 列 出 了 AdapterView 的 一 些 示例 : 

e ListView 

e GridView 

e Spinner 

e Gallery 

ft Android "P, BaseAdapter 类 有 以 下 几 个 子 类 ; 

e ListAdapter 

e ArrayAdapter 

e CursorAdapter 

e SpinnerAdapter 

对 于 ImageAdapter 类 ， 实 现 了 下 列 粗 体 显示 的 方法 : 


public class ImageAdapter extends BaseAdapter { 
public ImageAdapter (Context c) { ... } 


//---returns the number of images--- 
public int getCount() { ... } 


//---returns the item--- 
public Object getItem(int position) ( ... } 


//---returns the ID of an item--- 
public long getItemId(int position) { ... ) 


//---returns an ImageView view--- 
public View getView(int position, View convertView, 
ViewGroup parent) { ... } 
} 
特别 是 , getViewO 7 WERE TAY View. 在 本 例 中 , 返回 了 一 个 ImageView 对 象 。 
当选 定 (也 即 单 击 )Gallery 视图 中 的 一 张 图 像 时 , 将 显示 出 所 选 定 图 像 的 位 置 (第 一 张 图 
像 是 0， 第 二 张 图 像 是 1， 依 次 类 推 ) 并 在 ImageView 中 显示 此 图 像 。 


Gallery gallery = (Gallery) findViewBylId(R.id.galleryl); 


gallery.setAdapter (new ImageAdapter (this) ); 
gallery.setOnItemClickListener (new OnItemClickListener () 
{ 
public void onItemClick (AdapterView<?> parent, View v, 
int position, long id) 
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Toast.makeText (getBaseContext (), 
"pic" + {position + 1) + * selected", 
Toast.LENGTH SHORT) .show(); 


//---display the images selected--- 
ImageView imageView = 

(ImageView) findViewBylId(R.id.imagel) ; 
imageView.setImageResource (imageIDs [position] ) ; 


H; 


5.1.2 ImageSwitcher 


前 面 一 节 演 示 了 如 何 将 Gallery 视图 与 一 个 ImageView 视图 一 起 使 用 来 显示 一 系列 缩 
略图 像 ， 以 便当 其 中 之 一 被 选中 时 ， 选 定 的 图 像 在 ImageView 中 显示 。 然 而 ， 有 时 您 并 不 
想 当 用 户 在 Gallery 视图 中 选择 一 张 图 像 时 该 图 像 显 示 得 太 突然 一 一 例如 ， 您 也 许 希 望 在 
图 像 之 间 进 行 过 渡 时 应 用 一 些 动画 效果 。 这 时 ，Gallery 视图 就 需要 ImageSwitcher 来 配合 
人 使用。 下面 的 “ 试 一 试 ” 展 示 了 使 用 方法 。 


um 使 用 ImageSwitcher 视图 


ImageSwitcherzip f(fZ X PFRI BUTE Wrox.com E FE 


(1) 打开 Eclipse， 创 建 一 个 名 为 ImageSwitcher 的 Android m H . 
(2) 修改 main.xml 文件 ， 添 加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout width="fill parent" 
android: layout height="fill parent" 
android:orientation-"vertical" > 


<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Images of San Francisco" /> 


<Gallery 
android: id="@+id/galleryi" 
android: layout width="fill parent" 
android: layout height="wrap content" /> 


<ImageSwitcher 
android: id="@+id/switcher1i" 
android: layout width-"fill parent" 
android: layout height="fill parent" 
android: layout alignParentLeft="true" 
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android:layout alignParentRight-"true" 


android:layout alignParentBottom-"true" /> 


</LinearLayout> 


(3) 右 击 res/values 文件 来， 选择 New | File， 并 将 文件 命名 为 attrs.xml。 
(4) 在 attrs.xml 文件 中 输入 如 下 内 容 : 


<?xml version="1.0" encoding="utf-8"?> 

<resources> 
<declare-styleable name="Galleryl1"> 

<attr name-"android:galleryItemBackground" /> 
</declare-styleable> 

</resources> 


(5) 将 一 组 图 像 拖 放 到 res/drawable-mdpi 文件 夹 下 (参见 前 
对 话 框 时 ， 选 中 Copy files 选项 并 单 击 OK 按钮 。 


(6) 在 ImageSwitcherActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.ImageSwitcher; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 
{ 


android.app.Activity; 


android.content.Context; 


android.content.res.TypedArray; 


android.os.Bundle; 


android 
android 
android 
android 
android 
android 
android 
android 
android 
android 
android 


. View. View; 


. View. ViewGroup; 


. View. ViewGroup.LayoutParams ; 


.Vliew.animation.AnimationUtils; 


. widget 
. widget 
.widget 
.Widget 


.Widget. 
.Widget. 


. widget 


.AdapterView; 
.AdapterView.OnItemClickListener; 
.BaseAdapter; 

.Gallery; 


ImageSwitcher; 
ImageView; 


.ViewSwitcher.ViewFactory; 


个 图 像 示 例 )。 当 显示 


class ImageSwitcherActivity extends Activity implements ViewFactory 


//---the images to display--- 


Integer[] 


R 
R 
R 
R. 
R 
R 
R 


imageIDs = { 


.drawable.picl, 
.drawable.pic2, 
.drawable.pic3, 


drawable.pic4, 


.drawable.picb5, 
.drawable.pic6, 
.drawable.pic?7 
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private ImageSwitcher imageSwitcher; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


imageSwitcher = (ImageSwitcher) findViewById(R.id.switcherl) ; 

imageSwitcher.setFactory (this) ; 

imageSwitcher.setInAnimation(AnimationUtils.loadAnimation(this, 
android.R.anim.fade in)); 

imageSwitcher.setOutAnimation (AnimationUtils. loadAnimation (this, 
android.R.anim.fade out)); 


Gallery gallery = (Gallery) findViewById(R.id.galleryl1) ; 
gallery.setAdapter (new ImageAdapter (this)); 
gallery.setOnItemClickListener (new OnItemClickListener () 
{ 

public void onItemClick (AdapterView<?> parent, 

View v, int position, long id) 

{ 


imageSwitcher.setImageResource (imageIDs [position] ); 


}); 


public View makeView () 
{ 
ImageView imageView = new ImageView (this) ; 
imageView.setBackgroundColor (OxFF000000); 
imageView.setScaleType(ImageView.ScaleType.FIT CENTER); 
imageView.setLayoutParams (new 
ImageSwitcher.LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams.FILL PARENT) ) ; 
return imageView; 


public class ImageAdapter extends BaseAdapter 
{ 


Private Context context; 
private int itemBackground; 


public ImageAdapter (Context c) 
{ 


context = c; 


//---setting the style--- 

TypedArray a = obtainStyledAttributes (R.styleable.Gallery1); 

itemBackground = a.getResourceId( 
R.styleable.Galleryl android galleryItemBackground, 0); 
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a.recycle(); 


} 


//---returns the number of images--- 
public int getCount() 
{ 

return imageIDs.length; 


} 


//---returns the item--- 
public Object getItem(int position) 
{ 

return position; 


} 


//---returns the ID of an item--- 
public long getItemId(int position) 
{ 

return position; 


} 


//---returns an ImageView view--- 

public View getView(int position, View convertView, ViewGroup 
parent) 

{ 


ImageView imageView = new ImageView (context) ; 


imageView.setImageResource (imageIDs [position] ); 

imageView. setScaleType (ImageView.ScaleType.FIT XY); 
imageView.setLayoutParams (new Gallery.LayoutParams (150, 120)); 
imageView.setBackgroundResource (itemBackground) ; 


return imageView; prm 


r ImageSwitcher 


Images of San Francisco 


} 

(7) TZ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 图 5-6 
展示 了 Gallery 和 ImageSwitcher 视图 ， 有 两 个 图 像 集合 以 及 
选 定 的 图 像 。 

示例 说 明 

在 这 个 示例 中 ， 首 先 需要 注意 的 是 ImageSwitcherActivity 
不 但 扩展 了 Activity， 而 且 还 实现 了 ViewFactory。 为 了 使 用 
ImageSwitcher 视图 ， 需 要 实现 ViewFactory 接口 ， 它 创建 了 
可 与 ImageSwitcher 视 疼 一 起 使 用 的 视图 。 因 此 ， 需 要 实现 
makeView() 7; iX: : 


图 5-6 
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public View makeView () 


{ 
ImageView imageView = new ImageView (this) ; 
imageView. setBackgroundColor (0xFF000000); 
imageView. setScaleType (ImageView.ScaleType.FIT CENTER); 
imageView.setLayoutParams (new 
ImageSwitcher. LayoutParams ( 
LayoutParams.FILL PARENT, 
LayoutParams.FILL PARENT) ); 
return imageView; 
} 
这 个 方法 创建 一 个 新 的 View 来 添加 到 ImageSwitcher 视图 中 ， 在 本 例 中 这 是 一 个 
ImageView. 


就 像 前 一 节 的 Gallery 示例 ， 需 要 实现 一 个 ImageAdapter 类 来 将 一 系列 ImageView 视 
图 绑 定 到 Gallery 视图 上 。 

在 onCreate(0 方 法 中 ， 可 以 获得 对 ImageSwitcher 视图 的 引用 并 设置 动画 ， 指 定 图 像 应 
该 如 何 “ 淡 入 ”和 “淡出 ”视图 。 最 后 ， 当 在 Gallery 视图 中 选 定 一 张 图 像 时 ， 它 将 在 
ImageSwitcher 视图 中 显示 出 来 : 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


imageSwitcher = (ImageSwitcher) findViewById (R.id.switcherl); 

imageSwitcher.setFactory (this) ; 

imageSwitcher.setInAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade in)); 

imageSwitcher.setOutAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade out)); 


Gallery gallery = (Gallery) findViewById(R.id.galleryl); 
gallery.setAdapter (new ImageAdapter (this) ); 
gallery.setOniItemClickListener (new OnItemClickListener () 


{ 
public void onItemClick (AdapterView<?> parent, 
View v, int position, long id) 
{ 
imageSwitcher.setImageResource (imagelIDs[position]); 
} 
)); 


} 
本 例 中 ， 当 在 Gallery 视图 中 选 定 一 个 图 像 时 ， 它 将 以 “ 淡 入 ”的 方式 显示 出 来 。 当 
选 定 下 一 个 图 像 时 ， 当 前 图 像 将 淡出 。 如 果 想 让 图 像 从 左边 滑 入 ， 而 在 选择 男 一 幅 图 像 时 
再 从 右边 滑 出 ， 可 笃 试 下 和 面 的 动画 效 果 : 
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imageSwitcher.setInAnimation(AnimationUtils.loadAnimation(this, 
android.R.anim.slide in left)); 

imageSwitcher.setOutAnimation(AnimationUtils.loadAnimation(this, 
android.R.anim.slide out right)); 


9.1.3 GridView 


GridView 在 一 个 二 维 的 滚动 网 格 中 来 显示 项 。 可 以 将 GridView 与 一 个 ImageView fic 
合 使 用 来 显示 一 系列 图 像 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 做 到 这 一 点 。 


使 用 GridView 视图 


Grid.zip TCX PER LUITE Wrox.com E Ft 


(1) 打开 Eclipse， 创 建 一 个 名 为 Grid 的 Android 项 目 。 

(2) 将 一 组 图 像 拖 放 到 res/drawable-mdpi 文件 夹 下 (参见 前 一 个 图 像 示 例 )。 当 显示 一 个 
对 话 框 时 ， 选 中 Copy files 选项 并 单 击 OK 按钮 。 

(3) 在 main.xml 文件 中 输入 以 下 内 容 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«GridView 
android: id="@+id/gridview" 
android: layout width-"fill parent" 
android: layout height="fill parent" 
android:numColumns="auto fit" 
android: verticalSpacing="10dp" 
android: horizontalSpacing="10dp" 
android: columnWidth="90dp" 
android: stretchMode="columnWidth" 


android: gravity="center" /> 
</LinearLayout> 


(4) 在 GridActivityjava 文件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Grid; 


import android.app.Activity; 

import android.content.Context; 

import android.os.Bundle; 

import android.view.View; 

import android.view.ViewGroup; 

import android.widget.AdapterView; 

import android.widget.AdapterView.OnItemClickListener; 
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import android.widget.BaseAdapter; 
import android.widget.GridView; 
import android.widget.ImageView; 
import android.widget.Toast; 


public class GridActivity extends Activity | 
//---the images to display--- 
Integer[] imageIDs = { 

.drawable.picl, 

.drawable.pic2, 

.drawable.pic3, 

.drawable.pic4, 

.drawable.pic5, 

.drawable.pic6, 

.drawable.pic?7 


JJ pj p) p) WJ wj mJ 


E 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


GridView gridView = (GridView) findViewById(R.id.gridview); 
gridView.setAdapter (new ImageAdapter(this)); 


gridView.setOnItemClickListener (new OnItemClickListener () 
{ 
public void onitemClick (AdapterView parent, 
View v, int position, long id) 
{ 
Toast.makeText (getBaseContext(), 
"pic" + (position + 1) + " selected", 
Toast.LENGTH SHORT) .show() ; 


)); 


public class ImageAdapter extends BaseAdapter 
i 


private Context context; 
public ImageAdapter (Context c) 


{ 


context = c; 


//---returns the number of images--- 
public int getCount() { 
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return imageIDs.length; 


//---returns the item--- 
public Object getItem(int position) { 
return position; 


//---returns the ID of an item--- 
public long getItemId(int position) { 
return position; 


//---returns an ImageView view--- 
public View getView(int position, View convertView, 
ViewGroup parent) 
{ 
ImageView imageView; 
if (convertView == null) { 
imageView = new ImageView (context) ; 
imageView. setLayoutParams (new 
GridView.LayoutParams(85, 85)); 
imageView.setScaleType( 
ImageView.ScaleType.CENTER CROP); 
imageView.setPadding(5, 5, 5, 5); 
} else { 
imageView = (ImageView) convertView; 


imageView.setImageResource (imageIDs [position] ) ; 
return imageView; 


} 
(5) TZ F11 BEE Android RUAS Ud AU HA FER. 图 5-7 展示 了 显示 所 有 图 像 的 GridView. 


图 5-7 
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示例 说 明 
与 Gallery 和 ImageSwitcher 示例 一 样 ， 实 现 ImageAdapter 类 并 绑 定 到 GridView: 


GridView gridView = (GridView) findViewById(R.id.gridview); 
gridView.setAdapter (new ImageAdapter (this) ); 


gridView.setOnItemClickListener (new OnItemClickListener() 
i 

public void onItemClick(AdapterView parent, 

View v, int position, long id) 


{ 
Toast.makeText (getBaseContext (), 
"pic" + (position + 1) + ™ selected", 


Toast.LENGTH SHORT) .show(); 
}); 
当选 择 了 一 个 图 像 时 ， 将 显示 一 个 Toast 消 县 表明 该 图 像 已 被 选 定 。 
在 getView()Jj ik'h, 可 以 指定 图 像 的 大 小 ， 并 通过 为 每 幅 图 像 设 置 内 边 中 在 GridView 
中 对 图 像 进行 分 隔 : 


//---returns an ImageView view--- 
public View getView(int position, View convertView, 


ViewGroup parent) 


{ 
ImageView imageView; 
if (convertView == null) [| 
imageView = new ImageView(context); 
imageView.setLayoutParams (new 
GridView.LayoutParams(85, 85)); 
imageView.setScaleType( 
ImageView.ScaleType.CENTER CROP); 
imageView.setPadding(5, 5, 5, 5); 
} else | 
imageView = (ImageView) convertView; 
} 
imageView.setImageResource (imagelIDs[position]); 
return imageView; 
} 


52 将 菜单 和 视图 一 起 使 用 

菜单 用 来 显示 在 一 个 应 用 程序 的 主 用户 界 面 中 不 是 直接 可 见 的 额外 选项 。 在 Android 
中 有 两 种 主要 的 菜单 类 型 : 

e 选项 菜单 一 一 显示 和 当前 活动 相关 的 信息 。 在 Android F, 通过 单 击 并 按 下 MENU 
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按钮 来 激活 选项 菜单 。 
e 上 下 文 菜 单一 一 显示 和 活动 中 一 个 特定 的 视图 相关 的 信息 。 在 Android 中 ， 通 过 单 
击 并 按 住 视 图 来 激活 上 下 文 菜单 。 
图 5-8 展示 了 Browser 应 用 程序 中 的 一 个 选项 菜单 的 示例 。 当 用 户 按 下 MENU 按钮 时 ， 
选项 菜单 将 显示 出 来 。 所 显示 的 莱 单 项 随 当前 正在 运行 的 活动 而 各 异 。 
图 5-9 展示 了 当 用 户 按 住 页 面 上 的 一 幅 图 像 时 所 显示 的 上 下 文 菜单 。 显示 的 菜单 项 随 当 
前 选 定 的 组 件 或 视图 而 各 异 。 为 了 激活 上 下 文 菜单 ， 用 户 可 在 屏幕 上 选择 一 项 ， 然 后 按 住 它 。 


| rm 0 


New tab 


http;//www.blogcdn.com/ 


www engadget.com... 


. New incognito tab 


Save to bookmark: ` 
ave to bookmarks Save image 


Bookmarks 
< 
share page 


View image 


Set as wallpaper 


Find on page 
AX 


A Request desktop site 


Save for offline reading 


图 5-8 5.9 
5.2.1 创建 辅助 方法 


在 深入 学 习 和 创建 选项 菜单 以 及 上 下 文 菜 单 之 前 ， 再 要 创建 两 个 辅助 方法 。 一 个 创建 
将 在 茉 单 内 显示 的 项 列表 ， 另 一 个 处 理 用 户 在 荣 单 内 选 定 一 项 时 所 触发 的 事件 。 


创建 菜单 辅助 方法 


Menus.zip fCfZ X fF uJ UE Wrox.com E Ft 


(1) 打开 Eclipse， 创 建 一 个 名 为 Menus 的 Android Jii H . 
(2) 在 MenusActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.Menus; 


import android.app.Activity; 
import android.os.Bundle; 
import android.view.Menu; 
import android.view.MenuItem; 
import android.widget.Toast; 
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public class MenusActivity extends Activity I 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


private void CreateMenu (Menu menu) 


{ 


MenulItem mnul = menu.add(0, 0, 0, "Item 1"); 


mnul.setAlphabeticShortcut('a'); 
mnul.setIcon(R.drawable.ic launcher); 


MenulItem mnu2 = menu.add(0, 1, 1, "Item 2"); 


mnu2.setAlphabeticShortcut('b'); 
mnu2.setIcon(R.drawable.ic launcher); 


MenuItem mnu3 = menu.add(0, 2, 2, "Item 3"); 


mnu3.setAlphabeticShortcut('c'); 
mnu3.setIcon(R.drawable.ic launcher); 


MenulItem mnu4 = menu.add(0, 3, 3, "Item 4"); 
{ 
mnu4.setAlphabeticShortcut('d') ; 
} 
menu.add(0, 4, 4, "Item 5"); 
menu.add(0, 5, 5, "Item 6"); 
menu.add(0, 6, 6, "Item 7"); 


private boolean MenuChoice (MenuItem item) 
{ 
switch (item.getItemId()) { 
case 0: 
Toast.makeText (this, "You clicked on Item 1", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 1: 
Toast.makeText(this, "You clicked on Item 2", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 2: 
Toast.makeText (this, "You clicked on Item 3", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 3: 


227 


228 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


Toast.makeText (this, "You clicked on Item 4", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 4: 
Toast.makeText (this, "You clicked on Item 5", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 5: 
Toast.makeText (this, "You clicked on Item 6", 
Toast.LENGTH LONG) .show() ; 
return true; 
case 6: 
Toast.makeText (this, "You clicked on Item 7", 
Toast.LENGTH LONG) .show() ; 
return true; 


} 
return false; 
} 
} 
示例 说 明 


前 面 的 示例 创建 了 两 个 方法 : CreateMenu0 和 MenuChoice). CreatMenuQ 7; i; E 
个 Menu 参数 并 回 其 添加 一 系列 菜单 项 。 
为 了 向 菜单 中 添加 菜单 项 ， 需 要 创建 一 个 Menultem 类 的 实例 并 使 用 了 Menu 对 象 的 
add0 方 法 。 
MenuItem mnul = menu.add(0, 0, 0, “Item 1"); 
| mnul.setAlphabeticShortcut('a'); 


mnul.setlIcon(R.drawable.ic launcher); 


} 


add0 方 法 的 4 个 参数 如 下 所 示 : 

e groupId 一 一 菜单 项 所 在 的 组 的 标识 符 ， 使 用 0 表示 一 个 全 单项 不 在 一 个 组 中 

e itemId 一 一 唯一 的 菜单 项 ID 

e ”order 一 一 菜单 项 显示 的 顺序 

e title 一 一 菜单 项 显示 的 文本 

可 以 使 用 setAlphabeticShortcutO 方 法 来 给 某 单 项 分 配 快捷 键 ， 这 样 用 户 可 以 通过 在 键 
各 上 按键 来 选择 一 个 菜单 项 。setIcon0 方 法 设置 将 在 菜单 项 上 显示 的 图 像 。 

MenuChoice0 方 法 接受 一 个 Menultem 参数 ， 并 检查 其 ID 来 确定 被 选择 的 菜单 项 。 然 
后 ， 它 显示 一 个 Toast 消息 告诉 用 户 哪 一 个 菜单 项 被 选中 了 。 


5.2.2 ”选项 菜单 
现在 准备 修改 应 用 程序 , 使 得 当 用 户 在 Android 设备 上 按 下 MENU 按钮 时 显示 选项 菜单 。 
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显示 选项 菜单 


(1) 使 用 前 
的 语句 : 


- 节 所 创建 的 同一 个 项 目 ， 在 MenusActivityjava 文件 中 添加 下 列 粗 体 显示 


package net.learn2develop.Menus; 


import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.os.Bundle; 
android.view.Menu; 
android.view.Menultem; 
android.widget.Toast; 


class MenusActivity extends Activity { 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super. onCreate (savediInstancestate) ; 
setContentView(R.layout.main); 


@Override 
public boolean onCreateOptionsMenu (Menu menu) { 


super .onCreateOptionsMenu (menu); 
CreateMenu (menu) ; 
return true; 


@Override 
public boolean onOptionsItemSelected (MenuItem item) 


{ 


return MenuChoice (item); 


private void CreateMenu (Menu menu) 


{ 


(Pane 


private boolean MenuChoice (Menultem item) 


{ 


} 


Uf vaa 


(2) TE F11 键 在 Android EU As FAYE. Al 5-10 展示 了 当 单 击 MENU 按钮 时 所 弹 
HEDERA. BEE PE XCTI, BY DS EORR] SC ERO A DE] REA 到 D; 只 对 前 


4 个 亲 单 项 有 效 )。 


注意 虽然 代码 中 为 菜单 项 1-3 显示 了 图 标 ， 但 是 这 些 图 标 并 没有 显示 出 来 。 


(3) 如 果 将 AndroidManifest.xml 文件 的 最 低 SDK 属性 改 为 小 于 或 等 于 10， 然 后 在 模 
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拟 器 中 重新 运行 应 用 程序 ， 图 标的 显示 将 如 图 5-11 Bras. VER, BS 个 染 单项 之 后 的 所 有 
菜单 项 被 包含 在 名 为 More 的 菜单 项 中 。 单 击 More 将 显示 其 余 的 菜单 项 。 
«uses-sdk android:minSdkVersion="10" /> 


F 
E” 5554 ndreid di) 


Item 1 
Item 2 
Item 3 
Item 4 


Item 5 


Item 6 


Item 7 


图 5-10 图 5-11 


示例 说 明 

为 了 显示 活动 的 选项 菜单 ， 需 要 在 活动 中 实现 两 个 方法 : onCreateOptionsMenu() 和 
onOptionsItemSelected(). “4 MENU 按钮 被 按 下 时 调用 onCreateOptionsMenu0 方 法 。 在 这 

事件 中 ， 调 用 了 CreateMenu0 辅 助 方 法 来 显示 选项 亲 单 。 当 选择 了 一 个 菜单 项 上 时， 将 调 

用 onOptionsItemSelected0 方 法 。 这 时 ， 调 用 MenuChoice0 方 法 来 显示 所 选择 的 菜单 项 (并 
做 任何 想 做 的 事 )。 

注意 在 不 同 版 本 的 Android 中 选项 按钮 的 外 观 和 感觉 。 从 Honeycomb 开始 ， 选 项 沫 单 
项 不 再 有 图 标 ， 而 是 在 一 个 可 滚动 的 列表 中 显示 所 有 环 单 项 。 对 于 Honeycomb 之 前 的 
Android 版 本 ， 最 多 可 以 显示 5 个 菜单 项 ， 多 出 的 菜单 项 将 被 放 到 一 个 More 菜单 项 中 ,该 
菜单 项 代表 其 余 的 所 有 菜单 项 。 


523 上下文 菜单 


前 一 节 讲 述 了 在 用 户 按 下 MENU 按钮 时 是 如 何 显示 选项 菜单 的 。 除了 选项 琳 单 ,还 可 
以 显示 上 下 文 菜 单 。 上 下 文采 单 通常 和 活动 上 的 一 个 视图 相关 联 ， 并 在 用 户 长 按 一 个 项 时 
显示 。 例 如 ， 如 果 用 户 按 住 Button 视图 几 秒 钟 ， 就 会 显示 一 个 上 下 文 菜 单 。 
如 果 打 算 将 上 下 文 沫 单 和 活动 上 的 一 个 视图 联系 起 来 ， 需 要 调用 那个 视图 的 
setOnCreateContextMenuListener0 方 法 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 使 一 个 上 下 文 菜 单 与 
-个 Button 视图 进行 关联 。 
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显示 上 下 文 菜单 


Menus.zip VCI X fF uJ UTE Wrox.com E FE 
(1) 使 用 前 一 节 所 创建 的 同一 个 项 目 ， 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding="utf-8"?> 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 


«Button 
android: id="@+id/buttoni" 
android: layout width="match parent" 
android:layout height="wrap content" 
android: text="Click and hold on it" /> 


</LinearLayout> 


(2) 在 MenusActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 ; 


package net.learn2develop.Menus; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.ContextMenu; 

import android.view.ContextMenu.ContextMenuInfo; 
import android.view.Menu; 

import android.view.Menultem; 

import android.view.View; 

import android.widget.Button; 

import android.widget.Toast; 


public class MenusActivity extends Activity | 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedinstanceState) ; 
setContentView(R.layout.main); 


Button btn = (Button) findViewById(R.id.buttonl); 
btn.setOnCreateContextMenuListener(this); 
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QOverride 


public void onCreateContextMenu (ContextMenu menu, View view, 


ContextMenuInfo menuInfo) 


{ 
super.onCreateContextMenu(menu, view, menuInfo); 
CreateMenu (menu); 

} 

@Override 


public boolean onCreateOptionsMenu (Menu menu) { 


eer 
} 


QOverride 


public boolean onOptionsItemSelected (MenuItem item) 


{ 


return MenuChoice (item); 


} 


private void CreateMenu (Menu menu) 
{ 

PF onc 
} 


private boolean MenuChoice (MenuItem item) 
{ 

Ee 
} 


注意 : 如 果 之 前 将 AndroidManifest xml 文件 的 最 低 SDK 属性 改 为 10, 那么 一 


定 要 在 下 一 步 中 调试 应 用 程序 之 前 将 其 改 回 14。 


(3) TZ F11 键 在 Android 模拟 右上 调试 应 用 程序 。 图 5-12 
展示 了 在 长 按 Button 视图 时 所 显示 的 上 下 文 荣 单 。 

示例 说 明 

在 上 述 示 例 中 ， 调 用 Button 视图 的 setOnCreateContext 
MenuListener0 方 法 将 它 和 一 个 上 下 文 菜 单 建立 关联 。 

当 用 户 长 按 Button 视图 时 ，onCreateContextMenu0 方 法 
将 被 调用 。 在 这 一 方法 中 ， 通 过 调用 CreateMenu() 方 法 来 显 
IWE FLK. KM, 当 上 下 文 染 单 内 的 一 个 项 被 选中 时 ， 
onContextItemsSelected0 方 法 将 被 调用 ， 在 其 中 调用 Menu- 
Choice()7; 3::2K [n] Hl P? i zs — A HE 
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Item z 


Item 3 


Item 4 


Item 5 


Item 6 


Item r 


图 5-12 
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注意 , 菜单 项 的 快捷 键 并 未 生效 。 要 使 之 生效 ,需要 调用 Menu 对 象 的 setQuertyMode() 
方法 ， 如 下 所 示 : 
private void CreateMenu (Menu menu) 
{ 
menu. setQwertyMode (true); 
MenuItem mnul = menu.add(0, 0, 0, "Item 1"); 
{ 
mnul.setAlphabeticShortcut('a'); 
mnul.setIcon(R.drawable.ic launcher); 


5.3 ”其 他 一 些 视图 


除了 目前 已 经 了 解 的 标准 视图 之 外 ，Android SDK 还 提供 了 其 他 一 些 可 使 应 用 程序 变 
得 更 加 有 趣 的 视图 。 本 节 中 , TEE JU. FL]: AnalogClock、DigitalClock 和 WebView。 


5.3.1 AnalogClock 和 DigitalClock 视图 


AnalogClock 视图 显示 一 个 有 两 根 指针 (一 根 分 针 ， 一 根 时 针 ) 的 模拟 时 钟 ， 而 
DigitalClock 视图 以 数字 形式 显示 时 间 。 它 们 二 者 都 显示 的 是 系统 时 间 , 不 允许 用 户 用 来 显 
示 一 个 特定 时 间 ( 例 如 另 一 个 时 区 的 时 间 )。 因 此 ， 如 果 您 打算 显示 一 个 特定 时 区 的 时 间 ， 
就 必须 构建 一 个 目 己 的 定制 视图 。 


注意 ;' 在 Android 中 创建 一 个 自己 的 定制 视图 已 经 超出 了 本 书 的 范围 。 不 过 ， 
如 果 您 对 这 一 领域 感 兴趣 ， 可 以 在 Google 的 Android 文档 中 查看 这 一 主题 : 


http://developer.android.com/guide/topics/ui/custom—components.html. 


使 用 AnalogClock 和 DigitalClock til Z&4R f E HJ» Fig 28 YE XML 文件 (例如 main.xml) 
中 声明 它们 ， 如 下 所 示 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«AnalogClock 


android:layout width="wrap content" 
android:layout height="wrap content" /> 
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视图 。 
5.3.2 WebView 
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如 果 应 用 程序 需要 嵌入 一 些 Web 内 容 
些 提供 商 的 地 图 等 一 一 这 个 视图 就 很 有 用 。 下 面 的 “ 试 
试 ” 展 示 了 如 何以 编程 方式 加 载 一 个 Web 页 面 的 内 容 并 在 
活动 中 显示 出 来 。 
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<DigitalClock 
android: layout width="wrap content" 
android: layout height-"wrap content" /? 


</LinearLayout> 


图 5-13 展示 了 运用 中 的 AnalogClock 和 DigitalClock 


WebView 可 以 使 您 在 活动 中 对 入 一 个 Web uias. 
如 来 自 其 他 


图 5-13 


使 用 WebView 视图 


WebView.zip CAF X ff A] UTE Wrox.com E FÆ 


(1) 打开 Eclipse， 创 建 一 个 名 为 WebView 的 Android 新 项 目 。 
(2) 在 main.xml 文件 中 添加 以 下 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<WebView android: id="@+id/webviewl1" 
android: layout width="wrap content" 
android: layout height-"wrap content" /? 


</LinearLayout> 

(3) 在 WebViewActivity.java SFP ISIU F FUR S as Hj: 
package net.learn2develop.WebView; 

import android.app.Activity; 

import android.os.Bundle; 

import android.webkit.WebSettings; 


import android.webkit.WebView; 


public class WebViewActivity extends Activity | 
/** Called when the activity is first created. */ 
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@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


WebView wv = (WebView) findViewById(R.id.webviewl1) ; 


WebSettings webSettings = wv.getSettings(); 

webSettings.setBuiltiInZoomControls (true); 

wv.loadUrl( 
"http://chart.apis.google.com/chart" 4 
"?chs-300x225" + 
"&£cht-v" + 
"&£chco-FF6342,ADDE63,63C6DE" + 
"&£chd-t:100,80,60,30,30,30,10" + 
"&chdl-A|B|C"); 


} 
(4) 在 AndroidManifest.xml 文件 中 添加 下 面 的 权限 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.WebView" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android: name="android.permission. INTERNET" /> 


<application 

android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

«activity 
android: label="@string/app name" 
android:name-".WebViewActivity" > 
«intent-filter > 

<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category. 
LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 


(5) TZ F11 Æ Android 模拟 器 上 调试 应 用 程序 。 图 5-14 展示 了 WebView 的 内 容 。 
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|» | iiine dL 


m WebView 


图 5-14 
示例 说 明 
为 了 利用 WebView 来 加 载 一 个 Web 页 面 ， 可 以 使 用 loadUrl0 方 法 并 向 其 传 入 一 个 
URL, 如 F 所 JR: 
wv.loadUrl( 
"http://chart.apis.google.com/chart" + 
"?chs-300x225" + 
"&cht-v" 十 
"&chco-FF6342,ADDE63, 63C6DE" + 
"&chd-t:100,80,60,30,30,30,10" + 
"&chdl-A|B|C"); 
要 显示 内 置 的 缩放 控件 ， 需 要 首先 从 WebView 中 获取 WebSettings 属性 ， 然 后 调用 它 
的 setBuiltmZoomControlsO 方 法 : 
WebSettings webSettings = wv.getSettings(); 
webSettings.setBuiltInZoomControls (true); 
图 5-15 展示 了 在 Android 模拟 器 上 使 用 鼠标 单 击 并 抑 搜 WebView AW IN fe zr I] A 
缩放 控件 。 


注意 : 尽管 大 多 数 Android 设备 支持 多 点 触摸 屏幕 ， 但 当 在 Android 模拟 器 上 
测试 应 用 程序 时 ， 可 以 使 用 内 置 的 缩放 控件 对 Web 内 容 进 行 缩放 。 


有 时 ， 当 加 载 一 个 会 重 定 同 的 页 面 时 (例如 加 载 www.wrox.com 会 重 定 癌 到 www.wrox. 
com/wileyCDA), WebView 将 导致 应 用 程序 局 动 设备 的 Browser 应 用 程序 来 加 载 所 需 的 页 
面 。 在 图 5-16 中 ， 注 意 屏 幕 顶端 的 URL 栏 。 
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dndrow 4D 


5334:Android 4.0 


eran at 2010 


z7 Pme Amit 2 
$7 Sharerom | 
I: Administration 


B WebView 


5-15 图 5-16 


为 了 避免 这 种 情况 发 生 , 需要 实现 WebViewClient 类 并 重 写 shouldOverrideUrlLoading() 
方法 ， 如 下 面 的 示例 所 未 : 

package net.learn2develop.WebView; 

import android.app.Activity; 
import a 
import android.webkit.WebSettings; 
import android.webkit.WebView; 
import android.webkit.WebViewClient; 


ndroid.os.Bundle; 


public class WebViewActivity extends Activity | 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


WebView wv = (WebView) findViewById(R.id.webviewl); 


WebSettings webSettings - wv.getSettings(); 
webSettings.setBuiltInZoomControls (true); 
wv.setWebViewClient(new Callback(í()); 
wv.loadUrl("http://www.wrox.com"); 


private class Callback extends WebViewClient { 
@Override 
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public boolean shouldOverrideUrlLoading ( 
WebView view, String url) { 
return (false); 


} 


图 5-17 展示 了 现在 在 WebView 中 正确 加 载 Wrox.com 主页 。 


1 5350ndroid Al 


m WebView 


wrok Programmer to Programme! 


Home | Bookstore/E-Books P2P Programmer 


Find Wrox Titles 


Browse by Topic: 

All Titles Micrasoit Servers 
Mobile 
Open Source 
PHP/MySOI 
SharePoint 
SOL Server 
Visual Basic 

ac Web 
Microsoft Office — XML 


Search Titles: 


| Enter keyword, author or ISBN | 60 | 


图 5-17 


还 可 以 使 用 loadDataWithBaseURLO 方 法 动态 创建 一 个 HTML 字符 串 并 加 载 到 
WebView 中 : 
WebView wv = (WebView) findViewById(R.id.webviewl); 
final String mimeType = "text/html"; 
final String encoding = "UTF-8"; 
String html = "<H1>A simple HTML page</H1><body>" + 
"<p>The quick brown fox jumps over the lazy dog</p>" + 
"na /body»" - 
wv.loadDataWithBaseURL("", html, mimeType, encoding, ""); 


图 5-18 展示 了 由 WebView 所 显示 的 内 容 。 
此 外 ， 如 果 在 项 目的 assets 文件 夹 下 有 一 个 HTML 文件 (如 图 5-19 所 示 )， 还 可 以 使 用 
loadUrl0 方 法 将 其 加 载 到 WebView F: 


WebView wv = (WebView) findViewById(R.id.webviewl); 
wv.loadUrl("file:///android asset/Index.html"); 
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8 5554:Android_4.0 


p WebView 


A simple HTML page 


The quick brown fox jumps over the lazy 
dog 


图 5-18 


m 
LY Java - WebView/acsets/Index.html - Eclipse >|) 2) ^ 
File Edit Refactor Run Source Navigate Search Project Window Help 


B & AB Ënd: 0- Q- E (GP lave | $ Debug E DDMS $3 Java EE 
Ac aE- E a a D 
la Package Explorer 2! ™ H | E Inde.htmi 2 
i €H13A sinple HTML page</H1> 
2 = 2 <body> 
die WebView <p>The quick brown fox jumps over the lazy dog</p> 
4B sic <img src-"http://Wwww. google. com/Logos/Logo 68wht.gif" /> 
IH. net.learn2 develop. WebView </body> 
[J| WebViewActivityjava 
ca gen [Generated Java Files] 
E Android 4.0 
E. assets 
=| Index html 
i=» bin 
i= res 
(= drawable-hdpi 


图 5-19 


图 5-20 展示 了 WebView 的 内 容 。 


- 
8^ 5554 Àndroid 40D 


Bl webview 


A simple HTML page 


The quick brown fox jumps over the lazy 
dog 


Google 


图 5-20 
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54 本 章 小 结 


本 章 中 ,我 们 学 习 了 可 用 来 显示 图 像 的 各 种 视图 : Gallery、ImageView、ImageSwitcher 
和 GridView。 此 外 ， 还 了 解 了 选项 染 单 和 上 下 文 菜 单 的 不 同 ， 以 及 如 何在 应 用 程序 中 显示 
它们 。 最 后 ， 我 们 还 学 习 了 AnalogClock 和 DigitalClock 视图 (它们 以 图 形 化 的 方式 显示 当 
前 时 间 )， 以 及 用 来 显示 Web 页 面 内 容 的 WebView 视图 。 


1. ImageSwitcher 的 作用 是 什么 ? 

2. 说 出 在 活动 中 实现 选项 菜单 时 需要 重 写 的 两 个 方法 。 

3. 说 出 在 活动 中 实现 上 下 文 菜 单 时 需要 重 写 的 两 个 方法 。 

4. 当 在 WebView 中 发 生 重 定 同 时 如 何 防止 其 启动 设备 的 Web 浏览 器 ? 
练习 答案 参见 附录 C. 


si 
本 章 主 要 内 容 
ti 8 关键 概念 
使 用 Gallery 视图 在 水 平 滚动 列表 中 显示 一 系列 图 像 
<Gallery 
android:id="@tid/galleryl" 

Gallery android: layout width="fill parent" 

android:layout height="wrap content" /> 
<ImageView 
android: id="@+id/imagel" 

ImageView android: layout width="320px" 
android: layout height="250px" 
android:scaleType-"fitXY" /> 

使 用 ImageSwitcher 视图 当 在 图 像 间 切 换 时 应 用 动画 效果 


<ImageSwitcher 
android: id="@+id/switcherl1" 
android:layout width-"fill parent" 
ImageSwitcher android:layout height-"fill parent" 
android:layout alignParentLeft-"true" 
android:layout alignParentRight-"true" 
android:layout alignParentBottom-"true" /» 
使 用 GridView 在 一 个 二 维 的 滚动 网 格 中 显示 项 
<GridView 
android:id="@+id/gridview" 
android:layout width-"fill parent" 
GridView HB D HN RUE Mo gue ct pure 
android:numColumns-"auto fit" 
android:verticalSpacing-"lOdp" 
android:horizontalSpacing="10dp" 
android:columnWidth="90dp" 
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( 续 表 ) 
+ m 关键 概念 
android: stretchMode="columnWidth" 
GridView ! | 
android:gravity-"center" /» 
<AnalogClock 
AnalogClock android:layout width="wrap content" 
android:layout height="wrap content" /> 
<DigitalClock 
DigitalClock android: layout width="wrap content" 


android:layout height="wrap content" /> 
<WebView android:id="@+id/webviewl" 
WebView android: layout width-"wrap content" 
android:layout height="wrap content" /> 
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本 章 将 介绍 以 下 内 容 : 

e 如何 使 用 SharedPreferences 对 象 保存 简单 数据 

e 使 用 PreferenceActivity 类 来 允许 用 户 修改 首选 项 
e 如 何 写 入 和 读 取 内 部 和 外 部 存储 需 中 的 文件 

e 如 何 创建 并 使 用 SQLite 数据 库 


在 本 章 中 ， 我 们 将 学 习 如 何在 Android 应 用 程序 中 保持 数据 。 由 于 用 户 通常 希望 在 以 
后 重新 使 用 数据 ， 因 此 持久 化 数据 是 应 用 程序 开发 中 的 一 个 重要 主题 。 对 于 Android 来 说 ， 
持久 化 数据 主要 有 3 个 基本 的 方法 : 

e 用 来 保存 小 块 数据 的 轻 量 级 的 机 制 一 一 共享 首选 项 (shared preferences) 

e 传统 的 文件 系统 

e 通过 SQLite 数据 库 文 持 的 关系 数据 库 管理 系统 

本 章 中 讨论 的 技术 可 以 使 应 用 程序 创建 和 访问 它们 自己 的 私有 数据 。 在 第 7 章 ， 我 们 
将 学 习 如 何 路 应 用 程序 共享 数据 。 


6.1 保存 和 加 载 用 户 首 选项 


Android 提供 了 SharedPreferences 对 象 来 帮助 我 们 保存 简单 的 应 用 程序 数据 。 例 如 ， 
应 用 程序 可 能 有 一 个 允许 用 户 指定 在 应 用 程序 中 显示 的 文本 字体 大 小 的 选项 。 这 时 ， 应 用 
程序 需要 记 住 用 户 对 字体 的 设 定 值 ， 以 便 该 用 户 再 次 使 用 时 ， 它 可 以 正确 设置 字体 大 小 。 
为 了 达到 这 一 目的 ， 可 以 有 多 种 选择 。 将 数据 保存 在 一 个 文件 中 ， 但 这 需要 执行 一 些 文件 
管理 例 程 ， 诸 如 回 文 件 写 数 据 、 表 明 从 文件 中 读 取 多 少 字 符 等 。 另 外 ， 如 果 有 诸如 文本 尺 
寸 、 字 体 名 称 、 首 选 的 背景 色 等 多 条 信息 需要 保存 时 ， 写 文件 的 任务 就 会 变 得 更 加 繁重 。 

替代 写 入 文本 文件 的 方法 是 使 用 数据 库 ， 但 无 论 是 从 开发 人 员 的 角度 还 是 考虑 到 应 用 
程序 运行 时 的 性 能 ， 为 存储 简单 数据 而 使 用 数据 库 都 夸张 了 点 。 
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不 过 ,使 用 SharedPreferences 对 象 的 话 ， 可 以 通过 使 用 键 / 值 对 来 保存 所 需 的 数据 一 一 
为 需要 保存 的 数据 指定 一 个 键 ， 然 后 其 和 其 值 将 一 起 被 目 动 保存 到 一 个 XML 文件 中 。 
6.1.1 使 用 活动 访问 首选 项 
在 下 面 的 “ 试 一 试 ” 中 , 将 学 习 如 何 使 用 SharedPreferences 对 象 来 存储 应 用 程序 数据 。 


万 外 还 将 学 到 如 何 使 用 Android 操作 系统 提供 的 一 类 特殊 的 活动 ， 使 用 尸 能 够 直接 修改 存 


储 的 应 用 程序 数据 。 
使 用 SharedPreferences 对 象 保存 数据 


SharedPreferences.zip (CIX IERI UTE Wrox.com E FE 


(1) 使 用 Eclipse 创建 一 个 Android 项 目 , 命 名 为 UsingPreferences。 

(2) 在 res 文件 夹 中 创建 一 个 新 的 子 文 件 夹 ， 命 名 为 xml。 在 这 
个 新 建 的 文件 夹 中 添加 一 个 文件 ， 命 名 为 myapppreferences xml， 如 
图 6-1 Przn 

(3) 在 myapppreferences.xml 文件 中 输入 以 下 内 容 : 

<?xml version="1.0" encoding-"utf-8"?» 


<PreferenceScreen 
xmlns:android-"http://schemas.android.com/apk 


se UzingP references 


> ES src 
: 2E gen [Generated Java Files] 
> By Android 4.0 
Gb, assets 
. Es. bin 


4 i> res 


> (=> drawable-hdpi 
- [25 drawable-Idpi 
» [2- drawable-medgi 
> > layout 
4 (> values 
X| strings.xml 
à ( xml 


X| myapppreferences.xml 
ci Android lanifestxml 
|| proquard.ctg 


国 project.properties 


/res/android"> 
«PreferenceCategory android:title-"Category 1"> 
«CheckBoxPreference 
android:title-"Checkbox" 
android:defaultValue-"false" 
android:summary-"True or False" 
android:key-"checkboxPref" /> 
«/PreferenceCategory» 
«PreferenceCategory android:title-"Category 2"» 
«EditTextPreference 
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android:summary-"Enter a string" 

android:defaultValue-"[Enter a string here]" 

android:title-"Edit Text" 

android:key-"editTextPref" /> 
«RingtonePreference 

android:summary-"Select a ringtone" 

android:title-"Ringtones" 

android:key-"ringtonePref" /> 
«PreferenceScreen 

android:title-"Second Preference Screen" 

android:summary- 

"Click here to go to the second Preference Screen" 
android:key-"secondPrefScreenPref" > 
«EditTextPreference 

android:summary-"Enter a string" 
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android: title="Edit Text (second Screen)" 
android: key="secondEditTextPref" /> 
</PreferenceScreen> 
</PreferenceCategory> 
</PreferenceScreen> 


(4) EEA FS HINA, mMm N AppPreferenceActivity. 
(5) 在 AppPreferenceActivity.java 文件 中 输入 以 下 内 容 : 


package net.learn2develop.UsingPreferences; 


import android.os.Bundle; 
import android.preference.PreferenceActivity; 


public class AppPreferenceActivity extends PreferenceActivity { 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
//---load the preferences from an XML file--- 
addPreferencesFromResource (R.xml.myapppreferences); 


} 


(6) 在 AndroidManifest.xml 文件 中 ， 为 AppPreferenceActivity 类 添加 一 个 新 条 目 : 


<?xml version="1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.UsingPreferences" 
android:versionCode-"]" 
android:versionName-"].0" > 


«uses-sdk android:minSdkVersion-"14" /> 


«application 

android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

<activity 
android: label="@string/app name" 
android:name-".UsingPreferencesActivity" > 
<«intent-filter > 

«action android:name-"android.intent.action.MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«activity android:name-".AppPreferenceActivity" 
android: label="@string/app name"? 
«intent-filter» 
«action 
android:name-"net.learn2develop.AppPreference 
Activity" /» 
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<category android:name="android.intent.category .DEFAULT" /> 
</intent-filter> 
«/activity» 
</application> 


</manifest> 


(7) 在 main.xml SCF PSI FAL RS CS CS RNA TextView): 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btnPreferences" 
android: text="Load Preferences Screen" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: onClick="onClickLoad"/> 


<Button 
android: id="@+id/btnDisplayValues" 


android: 
android: 


android 


android: 


text="Display Preferences Values" 
layout width="fill parent" 


:layout height="wrap content" 


onClick-"onClickDisplay"/» 


«EditText 
android: id="@+tid/txtString" 
android: layout width="fill parent" 
android: layout height-"wrap content" /? 


«Button 
android: id="@+id/btnModifyValues" 
android: text="Modify Preferences Values" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: onClick="onClickModify"/> 


</LinearLayout> 

(8) 在 UsingPreferencesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 代码 : 
package net.learn2develop.UsingPreferences; 

import android.app.Activity; 

import android.content.Intent; 


import android.os.Bundle; 
import android.view.View; 
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public class UsingPreferencesActivity extends Activity 1 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 

super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


public void onClickLoad(View view) { 
Intent i = new Intent("net.learn2develop.AppPreferenceActivity"); 
startActivity (1); 


} 


(9) 按 F11 BEE Android 模拟 嚣 上 调试 应 用 程序 。 单 击 Load Preferences Screen 按钮 可 
看 到 首选 项 界面 ， 如 图 6-2 所 示 。 


F F 
E S53d:Android d E 35SebAndroid 4.0 


- UsingPreferences - UsingPreferences 


Load Preferences Screen CATEGORY 1 


Checkbox 


True or False 


Display Preferences Values 


CATEGORY 2 


Modify Preferences Values Edit Text 


Enter a string 


Ringtones 


Select a ringtone 


Second Preference Screen 
Click here to go to the second Preference 
screen 


图 6-2 


(10) 单 击 Checkbox 项 可 以 将 复 选 框 的 值 在 选中 与 未 选中 之 间 切 换 。 注 意 Category 1 
和 Category 2 这 两 个 类 别 。 单 击 Edit Text 项 ， 输 入 如 图 6-3 所 示 的 一 些 值 。 单 击 OK 按钮 
KR HIX HHE- 

(11) 单 击 Ringtones 项 ， 选 择 默 认 的 铃声 或 静音 模式 ， 如 图 6-4 所 示 。 如 果 在 真实 的 
Android 设备 上 测试 应 用 程序 ， 可 以 从 一 个 更 加 丰富 的 铃声 列表 中 进行 选择 。 

(12) 单 击 Second Preference Screen 项 会 进入 下 一 个 界面 ， 如 图 6-5 Prax. 
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3» | 555A direi df r - . | Fr 
日 555r cris du E| tinira 


m Second Preference Screen 


Edit Text (second Screen) 
Enter a string 


| Ringtones 
Edit Text 


| Default ringtone 
[Enter a string here] 


Silent 
Cancel 


Cancel 


图 6-3 图 6-5 


(13) 为 返回 前 一 个 界面 ， 单 击 Back 按钮 。 为 关闭 首选 项 界面 ， 需 要 再 次 单 击 Back Ha. 
(14) 修改 了 至 少 一 个 首选 项 的 值 后 ，Android 模拟 器 的 /data/datamet.learn2develop .Using 
Preferences/shared prefs 文件 夹 中 会 创建 一 个 文件 。 为 了 验证 这 一 点 ， 在 Eclipse 中 切换 到 
DDMS 透视 图 ， 观 察 File Explorer 选项 卡 ， 如 图 6-6 所 示 。 您 将 看 到 一 个 名 为 
net.learn2develop.UsingPreferences preferences.xml 的 XML 文件 。 
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图 6-6 
(15) 如 果 提 取 这 个 文件 并 观察 其 内 容 ， 可 以 看 到 如 下 所 示 的 代码 : 
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<?xml version-'1.0' encoding-'utf-8' standalone=" YeS ?> 
<map> 

«string name-"editTextPref"»[Enter a string here]</string> 
«string name="ringtonePref"></string> 

</map> 


示例 说 明 
首先 创建 了 一 个 名 为 myapppreferences.xml 的 XML 文件 来 存储 想 要 为 应 用 程序 保存 的 
首选 项 类 型 : 


<?xml version-"1.0" encoding-"utí-8"?» 

«PreferenceScreen 
xmlns:android-"http://schemas.android.com/apk/res/android"» 
<PreferenceCategory android:title-"Category 1"> 

<CheckBoxPreference 
android:title="Checkbox" 
android: defaultValue="false" 
android:summary="True or False" 
android: key="checkboxPref" /> 
</PreferenceCategory> 
<PreferenceCategory android:title="Category 2"> 
<EditTextPreference 
android:summary="Enter a string" 
android:defaultValue-"[Enter a string here]" 
android:title-"Edit Text” 
android:key-"editTextPref" /» 
<RingtonePreference 
android:summary="Select a ringtone" 
android:title-"Ringtones" 
android:key-"ringtonePref" /» 
«PreferenceScreen 
android:title-"Second Preference Screen" 
android:summary- 

"Click here to go to the second Preference Screen" 
android:key-"secondPrefScreenPref" > 
«EditTextPreference 

android:summary-"Enter a string" 

android:title-"Edit Text (second Screen)" 

android:key-"secondEditTextPref" /» 
</PreferenceScreen> 
</PreferenceCategory> 
</PreferenceScreen> 


在 前 面 的 代码 段 中 创建 了 以 下 内 容 : 


e 两 个 首选 项 类 别 ， 用 于 分 组 不 同 的 首选 项 类 型 。 

e 两 个 复 选 框 首 选项 ， 其 键 分 别 为 checkboxPref 和 secondEditTextPref. 
e 一 个 铃声 首选 项 ， 其 键 为 nngtonePref. 

e 一 个 首选 项 界面 ， 用 于 包含 附加 首选 项 。 
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android:key 属性 指定 了 可 以 在 代码 中 以 编程 方式 引用 以 设置 或 检索 该 首选 项 的 值 的 键 。 
为 了 使 操作 系统 显示 所 有 的 首选 项 供用 户 编辑 ， 创 建 了 一 个 活动 来 扩展 Preference- 
Activity 基 类 ,然后 调用 addPreferencesFromResourceO 方 法 来 加 载 包含 首选 项 的 XML 文件 : 
public class AppPreferenceActivity extends PreferenceActivity { 
@Override 
public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 


//---load the preferences from an XML file--- 
addPreferencesFromResource (R.xml.myapppreferences); 


} 
PreferenceActivity X Æ PHRF RKA NGA, qp HIP! So eA M EK 
为 了 显示 首选 项 的 活动 ， 使 用 一 个 Intent 对 象 调用 它 : 


Intent i = new Intent("net.learn2develop.AppPreferenceActivity"); 
StartActivity (1); 


对 首选 项 所 做 的 所 有 更 改 会 自动 保存 到 应 用 程序 的 shared. prefs 文件 夹 下 的 一 个 XML 
文件 中 。 
6.1.2 ”通过 编程 检索 和 修改 首选 项 值 

在 前 一 节 看 到 ，PreferenceActivity 类 既 允 许 开发 人 员 方 便 地 创建 首选 项 ， 叉 允许 用 户 
在 运行 时 修改 首选 项 。 为 了 在 应 用 程序 中 使 用 这 些 首选 项 , 需要 使 用 SharedPreferences 25. 
下 面 的 “ 试 一 试 ” 显 示 了 具体 做 法 。 
检索 和 修改 首选 项 

(1) 使 用 前 一 节 创 建 的 同一 个 项 目 , 在 UsingPreferencesActivity.java 文件 中 添加 下 列 粗 
体 显 示 的 代码 : 


package net.learn2develop.UsingPreferences; 


import android.app.Activity; 

import android.content.Intent; 

import android.content.SharedPreferences; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.EditText; 

import android.widget.Toast; 


public class UsingPreferencesActivity extends Activity 
/** Called when the activity is first created. */ 
@Override 


ceo 


public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView(R.layout.main); 
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public void onClickLoad(View view) { 
Intent i = new Intent ("net.learn2develop.AppPreferenceActivity"); 
startActivity (1); 


public void onClickDisplay (View view) { 
SharedPreferences appPrefs = 
getSharedPreferences ("net.learn2develop.UsingPreferences _ 
preferences", 
MODE PRIVATE) ; 
DisplayText (appPrefs.getString ("editTextPref", "")); 


public void onClickModify (View view) { 
SharedPreferences appPrefs = 
getSharedPreferences ("net.learn2develop.UsingPreferences © 
preferences", 

MODE PRIVATE) ; 

SharedPreferences.Editor prefsEditor = appPrefs.edit(); 

prefsEditor.putString("editTextPref", 
((EditText)findViewById(R.id.txtString)). getText(). 

toString()); 
prefsEditor.commit(); 


private void DisplayText(String str) { 
Toast.makeText (getBaseContext(), str, Toast.LENGTH LONG).show(); 

} 

(2) T£ F11 键 在 Android 模拟 右上 再 次 运行 应 用 程序 .这 一 次 , 单 击 Display Preferences 
Values 按钮 将 显示 如 图 6-7 所 示 的 值 。 

(3) 在 EditText 视图 中 输入 一 个 字符 串 ， 然 后 单 击 Modify Preferences Values 按钮 ， 如 
图 6-8 所 示 。 

(4) 现在 再 次 单 击 Display Preferences Values 按钮 。 注 意 新 值 将 被 保存 。 

示例 说 明 

在 onClickDisplay0 方 法 中 ， 首 先 使 用 getSharedPreferences0) 方 法 来 获得 SharedPreferences 
类 的 一 个 实例 。 这 是 通过 指定 XML 文件 的 名 称 实 现 的 ， 在 本 例 中 XML 文件 的 名 称 为 
net.learn2develop.UsingPreferences preferences， 其 格式 为 <PackageName> preferences。 为 了 检 
索 字符 串 首选 项 ， 使 用 getString0 方 法 ， 向 其 传 入 想 要 检索 的 首选 项 的 键 : 
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»* 555a8ndroid_ Ai 


al UsingPreferences P UsingPreferences 


Load Freferences Screen Load Preferences Screen 


Display Preferences Values Display Preferences Values 
some values here... 


Modify Preferences Values Modify Preferences Values 


[Enter a string here] 


图 6-7 图 6-8 


public void onClickDisplay (View view) { 
SharedPreferences appPrefs - 
getSharedPreferences ("net.learn2develop.UsingPreferences 
 prererences", 
MODE PRIVATE); 
DisplayText (appPrefs.getString("editTextPref", "")); 
} 


MODE PRIVATE 常量 表示 只 有 创建 首选 项 文件 的 应 用 程序 能 够 打开 首选 项 文件 。 

在 onClickModify0O 方 法 中 ， 通 过 SharedPreferences 对 象 的 edit0 方 法 创建 了 一 个 
SharedPreferences.Editor 对 象 。 为 了 修改 字符 串 首 选项 的 值 ， 使 用 了 putString0 方 法 。 为 了 
将 更 改 保存 到 首选 项 文件 中 ， 使 用 了 commit0 方 法 : 


public void onClickModify(View view) { 

SharedPreferences appPrefs = 
getSharedPreferences("net.learn2develop.UsingPreferences 
_ErFetereneces ， 

MODE PRIVATE) ; 

SharedPreferences.Editor prefsEditor = appPrefs.edit(); 

prefsEditor.putString("editTextPref", 

((EditText) findViewById(R.id.txtString)).getText(). 
toString ()); 

prefsEditor.commit (); 


} 
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6.1.3 修改 首选 项 文件 的 默认 名 称 


注意 ， 保 存在 设备 上 的 首选 项 文件 的 默认 名 称 是 netleam2develop.UsingPreferences - 
preferencesxml， 包 名 作为 前 组 。 但 是 在 有 些 时 候 ， 为 首选 项 文件 命名 一 个 特定 的 名 字 很 有 
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帮助 。 此 时 ， 可 以 执行 以 下 操作 。 
在 AppPreferenceActivity.java 文件 中 添加 下 列 粗 体 显 示 的 代码 : 


package net.learn2develop.UsingPreferences; 


import android.os.Bundle; 
import android.preference.PreferenceActivity; 
import android.preference.PreferenceManager; 


public class AppPreferenceActivity extends PreferenceActivity I 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


PreferenceManager prefMgr = getPreferenceManager () ; 
prefMgr.setSharedPreferencesName ("appPreferences") ; 


//---load the preferences from an XML file--- 
addPreferencesFromResource (R.xml.myapppreferences) ; 


) 


这 里 使 用 PreferenceManager 类 将 共享 首选 项 文件 的 名 称 设 为 appPreferences.xml。 
按照 如 下 所 示人 修改 UsingPreferencesActivity.java 文件 : 


public void onClickDisplay (View view) { 
/* 
SharedPreferences appPrefs - 
getSharedPreferences ("net.learn2develop.UsingPreferences 
preferences", 
MODE PRIVATE); 
*/ 
SharedPreferences appPrefs = 
getSharedPreferences ("appPreferences", MODE PRIVATE) ; 


DisplayText (appPrefs.getString ("edi tTextPref™, ™")); 


public void onClickModify(View view) { 
y* 
SharedPreferences appPrefs - 
getSharedPreferences ("net.learn2develop.UsingPreferences 
preferences", 
MODE PRIVATE); 
*/ 
SharedPreferences appPrefs = 
getSharedPreferences ("appPreferences", MODE PRIVATE); 


SharedPreferences.Editor prefsEditor = appPrefs.edit(); 
prefsEditor.putString("editTextPref", 
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((EditText) findViewById(R.id.txtString)).getText(). 
toString()); 
prefsEditor.commit(); 


重新 运行 应 用 程序 并 修改 首选 项 时 , 注意 现在 创建 了 一 个 appPreferences.xml X fr. WW 
IK] 6-9 所 示 。 
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图 6-9 
6.2 将 数据 持久 化 到 文件 中 


SharedPreferences 对 象 允 许 您 存储 最 适合 以 键 / 值 对 方式 进行 存储 的 数据 ， 例 如 用 户 
ID、 生 日 、 性 别 、 驾 照 号 码 等 数据 。 然 而 ， 有 时 您 还 是 希望 利用 传统 的 文件 系统 来 存储 数 
据 。 例 如 ， 您 可 能 想 存 储 ns ran aeons 
以 使 用 java.io 包 中 的 类 来 做 到 这 一 点 。 


6.2.1 保存 到 内 部 存储 器 


Android 应 用 程序 中 保存 文件 的 第 一 个 方法 就 是 将 其 写 入 设备 的 内 部 存储 器 。 下 面 的 
“ 试 一 试 ” 展 示 了 如 何 将 用 户 输入 的 一 个 字符 串 保存 到 设备 的 内 部 存储 器 中 。 


将 数据 保存 到 内 部 存储 器 


Files.zip (CRIER UTE Wrox.com E FE 
(1) 打开 Eclipse， 创 建 一 个 Android 项 目 ， 命 名 为 Files. 
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(2) 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 

android:layout height-"fill parent" 

android:orientation-"vertical" > 


«TextView 

android:layout width-"fill parent" 

android:layout height-"wrap content" 

android:text-"Please enter some text" /> 
«EditText 

android: id="@+id/txtText1" 

android: layout width-"fill parent" 

android: layout height-"wrap content" /> 
<Button 

android: id="@+id/btnSave" 

android: text="Save" 

android: layout width-"fill parent" 

android: layout height-"wrap content" 

android: onClick="onClickSave" /> 
<Button 

android: id="@+id/btnLoad" 

android: text="Load" 

android: layout width-"fill parent" 

android: layout height="wrap content" 

android: onClick="onClickLoad" /> 
</LinearLayout> 


(3) 在 FilesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句: 


package net.learn2develop.Files; 


import java.io.FileInputStream; 
import 
import 
import 


import 


java.io.FileOutputStream; 


java.io.IOException; 
jJava.io.InputStreamReader; 
jJava.io.OutputStreamWriter; 
import android.app.Activity; 
import android.os.Bundle; 
import 
import 
import 


android.view.View; 
android.widget.EditText; 
android.widget.Toast; 


public class FilesActivity extends Activity | 
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EditText textBox; 
static final int READ BLOCK SIZE = 100; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


textBox = (EditText) findViewById(R.id.txtText1); 


public void onClickSave (View view) | 
String str = textBox.getText().toString(); 
try 
i 
FileOutputStream fOut - 
openFileOutput("textfile.txt", 
MODE WORLD READABLE) ; 
OutputStreamWriter osw = new 
OutputStreamWriter (fOut); 


//---write the string to the file--- 
osw.write(str); 

osw.flush(); 

osw.close(); 


//---display file saved message--- 

Toast.makeText(getBaseContext(), 
"File saved successfully!", 
Toast.LENGTH SHORT).show(); 


//---clears the EditText--- 
textBox.setText(""):; 

} 

catch (IOException ioe) 

{ 


loe.printStackTrace(); 


public void onClickLoad(View view) { 
try 
{ 
FileInputStream fIn = 
openFileInput("textfile.txt"); 
InputStreamReader isr - new 
InputStreamReader (fIn) ; 
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char[] inputBuffer = new char[READ BLOCK SIZE]; 
String s = ""; 


int charRead; 
while ((charRead = isr.read(inputBuffer) )>0) 
{ 
//---convert the chars to a String--- 
String readString = 
String.copyValueOf (inputBuffer, 0, 
charRead) ; 
s += readString; 


inputBuffer = new char[READ BLOCK SIZE]; 
} 
//---set the EditText to the text that has been 
// read--- 
textBox.setText(s); 


Toast.makeText(getBaseContext(), 
"File loaded successfully!", 
Toast.LENGTH SHORT).show(); 

} 

catch (IOException ioe) { 

ioe .printStackTrace () ; 


= 
2 5554 Android d. 


} 


(4) FX F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 
(5) 在 EditText 视图 中 输入 一 些 文本 (如 图 6-10 所 示 )， 
然后 单 击 Save 按钮 。 
(O 如 果 文 件 成 功 保存 ,将 看 到 由 Toast 类 显示 出 的 消 县 
“File saved successfully!". EditText 视图 中 的 文本 将 消失 。 
(7) "Ei; Load 按钮 ， 将 又 会 看 到 字符 串 出 现在 
EditText 视图 中 。 这 表明 文本 被 正确 地 保存 了 。 


示例 说 明 图 6-10 
为 了 将 文本 保存 到 文件 中 ， 要 使 用 FileOutputStream 类 。openFileOutputO 方 法 用 指定 
的 模式 ， 打 开 一 个 指定 的 文件 来 写 入 。 在 本 例 中 ,使 用 MODE WORLD READABLE 常量 
来 表示 此 文件 可 被 其 他 所 有 应 用 程序 读 取 ; 
FileOutputStream fOut = 


openFileOutput ("textfile.txt", 
MODE WORLD READABLE) ; 
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除了 MODE WORLD READABLE 常量 之 外 ， 还 可 以 从 以 下 模式 中 进行 选择 : 
MODE _ PRIVATE( 文 件 只 能 被 创建 它 的 应 用 程序 访问 )、MODE _ APPEND( 附 加 到 现 有 文件 ) 
fll MODE WORLD WRITEABLE( 文 件 对 于 其 他 所 有 应 用 程序 来 说 都 是 可 写 的 )。 
为 了 将 字符 流转 换 为 字 节 流 ， 要 利用 OutputStreamWriter 类 的 一 个 实例 ， 并 给 它 传递 
-个 FileOutputStream 对 象 的 实例 : 


OutputStreamWriter osw = new 


OutputStreamWriter(fOut); 


然后 使 用 其 write0 方 法 将 字符 串 写 入 到 文件 中 。 使 用 flush0 方 法 来 保证 所 有 字 节 都 写 
入 文件 。 最 后 ， 使 用 close0 方 法 来 关闭 文件 : 


//---write the string to the file--- 
osw.write (str); 

osw.flush(); 

osw.close(); 


为 了 证 取 文 件 内 容 ，FileInputStream 类 和 InputStreamReader 类 要 配合 使 用 : 


FilelnputStream fIn = 


openFileInput("textfile.txt"); 
InputStreamReader isr — new 


InputStreamReader(fIn); 


由 于 不 清楚 要 读 取 的 文件 的 大 小 , 因此 按 100 个 字符 为 一 块 将 文件 内 容 读 到 缓冲 区 ( 字 
符 数 组 ) 中 。 然 后 将 所 读 字 符 复 制 到 一 个 String 对 象 中 : 


char[] inputBuffer = new char[READ BLOCK SIZE]; 
String s = "s 


int charRead; 


while ((charRead = isr.read(inputBuffer) )>0) 
{ 
//---convert the chars to a String--- 
String readString - 


String.copyValueOf(inputBuffter, 0, 
charRead); 
S += readString; 


inputBuffer = new char[READ BLOCK SIZE]; 
} 


InputStreamReader 对 象 的 read0 方 法 恋 取 所 读 宇 符 的 个 数 ,， 如 条 到 达 文 件 末尾 ， 束 返回 -1。 

"AE Android 模拟 器 上 测试 此 应 用 程序 时 , 可 以 使 用 DDMS 透视 图 来 验证 应 用 程序 的 
确 将 文件 保存 在 了 其 files 目录 中 (如 图 6-11 所 示 ; 完整 路 径 是 /data/data/net.learn2develop. 
Files/files). 
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DDMS - Filessrc/net/leam2develop/Files/FilesActieity.java - Eclipse 
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6-11 
6.2.2 ”保存 到 外 部 存储 器 (SD 卡 ) 


前 面 一 节 讲 述 了 如 何 将 文件 保存 到 Android 设备 的 内 部 存储 器 。 有 了 时， 将 文件 保存 到 
外 部 存储 器 (例如 SD 卡 ) 也 是 很 有 用 的 , 这 是 因为 外 部 存储 器 容量 大 , 而且 很 容易 和 其 他 用 
户 共 享 文件 (只 要 将 SD 卡 移 到 别人 的 设备 里 就 行 了 )。 

使 用 前 一 节 中 创建 的 项 目 作为 例子 ， 为 了 将 用 户 输 入 的 文本 保存 在 SD 卡 中 ， 按 粗 体 
显示 内 容 修改 Save 按钮 的 onClick0 方 法 : 


import 
import 
import 
import 
import 
import 


import 
import 
import 
import 
import 
import 


java.io.File; 
java.io.FileInputStream; 
java.io.FileOutputStream; 
java.io.IOException; 
java.io.InputStreamReader; 
java.io.OutputStreamWriter; 


android.app.Activity; 
android.os.Bundle; 
android.os.Environment; 
android.view.View; 
android.widget.EditText; 
android.widget.Toast; 


public void onClickSave (View view) 


í 


String str = textBox.get Text () .toString(); 


LEY 
{ 
//---SD Card Storage--- 


File sdCard = Environment. getExternalStorageDirectory() ; 
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File directory = new File (sdCard.getAbsolutePath() + 
"/MyFiles"); 

directory.mkdirs(); 

File file = new File(directory, "textfile.txt"); 
FileOutputStream fOut = new FileOutputStream(file); 


/* 
FileOutputStream fOut = 
openFileOutput ("textfile.txt", 
MODE WORLD READABLE) ; 


a 


OutputStreamWriter osw = new 
OutputStreamWriter(fOut); 


//---write the string to the file--- 
osw.write(str); 

osw.flush(); 

osw.close(); 


//---display file saved message--- 

Toast.makeText(getBaseContext(), 
"File saved successfully!", 
Toast.LENGTH SHORT).show(); 


//---clears the EditText--- 
textBox.setText ("");}; 


} 
catch (IOException ioe) 
{ 
10e.printStacktTrace(); 
} 


} 


上 述 代码 使 用 getExtermalSstorageDirectoryO 方 法 返回 外 部 存储 器 的 完整 路 径 。 一 般 而 
言 ， 对 于 真实 设备 返回 /sdcard 路 径 ， 对 于 Android 模拟 器 返回 /mnt/sdcard 路 径 。 然 而 ， 永 
远 不 要 试图 用 便 编 码 的 方式 指定 SD 卡 的 路 径 ， 因 为 制造 商 可 能 会 给 SD 卡 指 派 一 个 不 同 
的 路 径 名 称 。 因 此 ， 应 确保 使 用 getExternalStorageDirectory0 方 法 来 返回 指向 SD 卡 的 完整 
路 径 。 

然后 在 SD 卡 中 创建 一 个 名 为 MyFiles 的 目录 。 最 终 ， 文 件 将 保存 在 此 目录 下 。 

为 了 从 外 部 存储 器 中 加 载 文 件 ， 需 要 为 Load 按钮 修改 onClickLoad0 方 法 : 

public void onClickLoad(View view) { 


try 


{ 
//---SD Storage--- 
File sdCard = Environment.getExternalStorageDirectory(); 
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File directory = new File (sdCard.getAbsolutePath() + 
"/MyFiles"); 

File file = new File(directory, "textfile.txt"); 

FileInputStream flIn = new FileInputStream(file); 

InputStreamReader isr = new InputStreamReader (fIn) ; 


/* 

FilelnputStream fIn - 
openFileInput("textfile.txt"); 

InputStreamReader isr = new 
InputStreamReader (fIn); 

er 


char[] inputBuffer = new char[READ BLOCK SIZE]; 


String s = ™"; 


int charRead; 
while ((charRead = isr.read(inputBuffer) )>0) 
{ 
//---convert the chars to a String--- 
String readString = 
String.copyValueOf(inputBuffer, 0, 
charRead); 
S += readString; 


inputBuffer = new char[READ BLOCK SIZE]; 


] 
//---set the EditText to the text that has been 
// read--- 


textBox.setText(s); 


Toast.makeText (getBaseContext (), 
"File loaded successfully! ", 
Toast.LENGTH SHORT) .show(); 

} 
catch (IOException ioe) { 
ioe.printStackTrace(); 


} 


注意 , 要 写 入 到 外 部 存储 器 , 需要 在 AndroidManifest.xml 文件 中 添加 WRITE EXTERNAL _ 
STORAGE 权限 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Files" 
android:versionCode-"1" 
android:versionName="1.0" > 
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«uses-sdk android:minSdkVersion="14" /> 
«uses-permission 
android:name-"android.permission.WRITE EXTERNAL STORAGE" /? 


«application 
android:icon="@drawable/ic launcher" 
android:label="@string/app name" > 
<activity 
android: label="@string/app name" 
android:name=".FilesActivity" > 
<intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
</application> 


</manifest> 


如 果 运 行 前 面 修改 过 的 代码 ， 会 看 到 /mnt/sdcard/MyFiles/ 文 件 夹 下 创建 了 一 个 文本 文 
件 ， 如 图 6-12 所 示 。 
iu DOMS - Files/src/net/leamzZdevelop/Files/Files&ctivity.java - Eclipse 


File Edit Run Source Wavigate Search Project Refactor Window Help 
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comandroid. launcher 763 | = Alarms 2011-10-20 
com.android.calendar 787 » E> DAM 2011-11-14 
android.process.acore 819 D a 2011-10-20 
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Launching Dialog 


图 6-12 
6.2.3 选择 最 佳 存 储 选项 


前 面 的 小 节 摘 述 了 在 Android 应 用 程序 中 保存 数据 的 3 种 主要 方式 :SharedPreferences、 
内 部 存储 器 和 外 部 存储 器 。 在 应 用 程序 中 应 该 选择 哪 一 种 呢 ? 以 下 是 一 些 建议 : 
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e 加 果 数 据 可 以 用 键 / 值 对 表示 ， 那 么 使 用 SharedPreferences 对 象 。 例 如 ， 如 果 想 要 
存储 用 户 首选 项 的 数据 ， 如 用 户 姓 名 、 背 景色 、 和 生日、 最 后 登录 日 期 等 ， 那 么 使 用 
SharedPreferences 对 象 来 存储 这 些 数据 是 一 个 理想 的 方法 。 而 且 ， 您 也 不 用 杀 目 操 
心 这 些 数据 是 如 何 存储 的 ; 所 有 需要 您 做 的 只 是 使 用 SharedPreferences 对 象 存 储 和 
检索 它们 。 

e 如 果 南 要 存储 临时 数据 ， 使 用 内 部 存储 器 是 一 个 好 的 选择 。 例 如 ， 应 用 程序 (如 一 
个 RSS [5] i d8) UH] Be mi e RA Web 上 下 载 的 图 像 。 在 这 种 情况 下 ,将 图 像 保 存在 
内 部 存储 器 上 是 一 个 好 的 解决 方法 。 您 也 许 还 希望 持久 化 用 户 所 创建 的 数据 ， 例 如 
有 一 个 备 态 录 应 用 程序 可 以 用 来 让 用 户 记 些 笔记 并 保存 它们 以 备 后 用 .在 所 有 这 些 
情况 下 ， 使 用 内 部 存储 器 是 一 个 好 的 选择 。 

e 有 时 需要 和 其 他 用 户 共享 应 用 程序 数据 。 例 如 ， 您 创建 了 一 个 Android 应 用 程序 来 
记录 用 户 兽 经 去 过 的 地 点 的 坐标 ， 并 想 与 其 他 用 户 分 享 这 些 数据 。 在 这 种 情况 下 ， 
可 以 将 文件 存储 在 设备 的 SD 卡 上 ， 这 样 用 户 在 后 面 可 以 很 容易 地 将 数据 转移 到 其 
他 设备 (和 计算 机 ) 上 来 使 用 。 

6.2.4 使 用 静态 资源 


除了 在 运行 时 动态 地 创建 和 使 用 文件 之 外 ， 还 可 以 在 设计 时 将 文件 添加 到 包 ， 以 便于 
在 运行 时 使 用 它 。 例 如 ， 您 可 能 需要 与 包 捆绑 一 些 帮 助 文件 ， 以 便于 用 户 需 要 时 可 以 显示 
一 些 帮 助 信息 。 这 时 ， 可 以 在 包 下 面 的 res/raw 文件 夹 (需要 自己 创建 ) 下 添加 文件 。 图 6-13 
lias J res/raw 文件 夹 包含 了 一 个 名 为 textfile.txt 的 文件 。 


uu Java - Files/res/raw/textfile.txt - Eclipse 


File Edit Run Source Mawigate Search Project Refactor Window Help 
Fi [gl E E: ad ES [S ova) $ Debug VS DDMS 59 Java EE 
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[ B bin 
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(2) AndroidManifest.xml 
E| praquard.cfq 


图 6-13 


为 了 在 代码 中 使 用 此 文件 , 要 利用 Activity 类 的 getResources0 方 法 返回 一 个 Resources 
对 象 ， 然 后 使 用 其 openRawResource0 方 法 来 打开 包含 在 res/raw 文件 夹 下 的 文件 : 


import Jjava.io.BufferedReader; 
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import java.io.InputStream; 


public class FilesActivity extends Activity { 
EditText textBox; 
static final int READ BLOCK SIZE = 100; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


textBox = (EditText) findViewById(R.id.txtTextl); 


InputStream is = this.getResources() .openRawResource 
(R. raw. textfile) ; 
BufferedReader br = new BufferedReader (new InputStreamReader (is) ) ; 
String str = null; 
try { 
while ((str = br.readLine()) != null) { 
Toast.makeText (getBaseContext(), 
str, Toast.LENGTH SHORT) .show() ; 
} 
is.close(); 
br.close(); 
} catch (IOException e) { 
e.printStackTrace(); 
} 
} 


存储 在 res/raw 文件 夹 下 的 资源 的 了 pp 是 以 其 不 带 扩 展 名 的 文件 名 来 命名 的 。 例 如 ， 如 
果 文 本 文件 是 textfile.txt， 那 么 它 的 资源 ID 就 是 R-raw.textfile. 


6.3 创建 和 使 用 数据 库 


到 目前 为 止 , 您 所 看 到 的 所 有 技术 都 用 来 保存 简单 的 数据 集合 。 对 于 存储 关系 型 数据 ， 
使 用 数据 库 会 更 有 效 。 例 如 ， 如 果 您 想 存储 一 所 学 校 所 有 学 生 的 测验 结果 ， 那 么 使 用 数据 
库 来 表示 它们 要 有 效 得 多 ， 因 为 可 以 使 用 数据 库 查 询 来 检索 一 个 特定 学 生 的 结果 。 此 外 ， 
使 用 数据 库 可 以 通过 在 不 同 数据 集合 间 指 定 关 系 来 强制 数据 完整 性 。 

Android 使 用 的 是 SQLite 数据 库 系 统 。 为 一 个 应 用 程序 所 创建 的 数据 库 只 能 被 此 应 用 
程序 访问 ; 其 他 应 用 程序 将 不 能 访问 它 。 

本 节 中 ,将 学 习 如 何以 编程 方式 在 Android 应 用 程序 中 创建 一 个 SQLite 数据 库 . 对 于 Android, 
在 一 个 应 用 程序 中 以 编程 方式 创建 的 SQLite 数据 库 总 是 存储 在 /data/data/<package_ 
name>/databases 文件 夹 下 。 


BOR 数据 持久 化 


6.3.1 创建 DBAdapter 辅助 类 


处 理 数据 库 的 一 个 好 的 做 法 是 创建 一 个 辅助 类 来 封装 访问 数据 的 所 有 复杂 性 ， 使 之 对 
于 调用 它 的 代码 来 说 是 透明 的 。 因 此 ， 在 本 节 中 将 创建 一 个 
名 为 DBAdapter 的 辅助 类 ， 用 来 创建 、 打 开 、 关 闭 和 使 用 
个 SQLite 数据 库 。 

本 例 中 ,将 创建 一 个 名 为 MyDB 的 数据 库 ， 包 含 一 张 名 
为 contacts 的 表 。 这 个 表 有 3 Fil: id, name 和 email( 如 图 
6-14 所 示 )。 


创建 数据 库 辅助 类 


Databases.zip fCfg X fF A HUE Wrox.com E Ft 


(1) 打开 Eclipse， 创 建 一 个 名 为 Databases 的 Android Jii H . 
(2) 在 包 中 新 增 一 个 Java 类 文件 , 并 命名 为 DBAdapter (如 — [ 2 5 databases 


4 [B sre 


ll 6-15 所 示 )。 4 H3 netlearn2develop.Databases 
| o m > LB) DatabasesActivity java 

(3) 在 DBAdapter.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : o, nni 

b E gen|bGenerated Java Files 

b HA Android 4.0 
package net.learn2develop.Databases; E assets 

c= 
import android.content.ContentValues; 回 AndroidManifest.xml 

= proguard.cf 

import android.content.Context; = 


import android.database.Cursor; 

import android.database.SQLException; 

import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper ; 
import android.util.Log; 


6-15 


public class DBAdapter { 
static final String KEY ROWID = " id"; 
static final String KEY NAME = "name"; 
static final String KEY EMAIL = "email"; 
static final String TAG = "DBAdapter"; 


static final String DATABASE NAME = "MyDB"; 


static final String DATABASE TABLE = "contacts"; 


static final int DATABASE VERSION = 1; 

static final String DATABASE CREATE = 
"create table contacts ( id integer primary key autoincrement, " 
+ "name text not null, email text not null);"; 


final Context context; 


DatabaseHelper DBHelper; 
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SQLiteDatabase db; 


public DBAdapter (Context ctx) 
{ 
this.context = ctx; 
DBHelper = new DatabaseHelper (context) ; 


private static class DatabaseHelper extends SQLiteOpenHelper 
{ 
DatabaseHelper (Context context) 
{ 
super (context, DATABASE NAME, null, DATABASE VERSION); 


QOverride 
public void onCreate(SQLiteDatabase db) 
{ 
try { 
db.execSQL (DATABASE CREATE); 
} catch (SQLException e) { 
e.printStackTrace () ; 


@Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int 
newVersion) 


Log.w(TAG, "Upgrading database from version " + oldVersion+t"to " 
+ newVersion + ", which will destroy all old data"); 

db.execSQL("DROP TABLE IF EXISTS contacts"); 

onCreate (db); 


//---opens the database--- 
public DBAdapter open() throws SQLException 
i 
db = DBHelper.getWritableDatabase(); 
return this; 


//---closes the database--- 
public void close() 
i 

DBHelper.close(); 


//---insert a contact into the database--- 
public long insertContact(String name, String email) 


{ 
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ContentValues initialValues = new ContentValues(); 


initialValues.put (KEY NAME, name) ; 
initialValues.put (KEY EMAIL, email); 


return db.insert (DATABASE TABLE, null, initialValues) ; 


//---deletes a particular contact--- 
public boolean deleteContact(long rowId) 
{ 


return db.delete (DATABASE TABLE, KEY ROWID + "=" + rowId, null) >0; 


//---retrieves all the contacts--- 
public Cursor getAllContacts () 
{ 


return db.query (DATABASE TABLE, new String[] {KEY ROWID, KEY NAME, 
KEY EMAIL}, null, null, null, null, null); 


//---retrieves a particular contact--- 


public Cursor getContact(long rowId) throws SQLException 


{ 


Cursor mCursor = 


db.query(true, DATABASE TABLE, new String[] (KEY ROWID, 
KEY NAME, KEY EMAIL), KEY ROWID + "=" + rowId, null, 


null, null, null, null); 
if (mCursor != null) { 
mCursor.moveToFirst(); 
) 


return mCursor; 


/ / ---updates a contact--- 


public boolean updateContact(long rowId, String name, String email) 


i 
ContentValues args - new ContentValues(); 
args.put(KEY NAME, name); 
args.put(KEY EMAIL, email); 


return db.update(DATABASE TABLE, args, KEY ROWID + "=" + rowId, 


null) » 0; 


} 
示例 说 明 
首先 为 在 数据 库 中 将 要 创建 的 表 定 义 几 个 音量 来 包含 不 同 的 字段 : 


static final String KEY ROWID = " id"; 
static final String KEY NAME = "name"; 
Static final String KEY EMAIL = "email"; 
Static final String TAG - "DBAdapter"; 


static final String DATABASE NAME = "MyDB"; 
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Static final String DATABASE TABLE = "contacts"; 
static final int DATABASE VERSION = 1; 


Static final String DATABASE CREATE = 
"create table contacts ( id integer primary key autoincrement, " 
+ "name text not null, email text not null);"; 


ft, DATABASE CREATE 常量 包含 了 用 于 在 MyDB 数据 库 中 创建 contacts 表 的 
SQL 语句 。 

在 DBAdapter 类 中 ， 还 添加 了 一 个 私有 类 来 扩展 SQLiteOpenHelper 类 ， 它 是 一 个 在 
Android 中 用 来 处 理 数 据 库 创建 和 版 本 管理 的 辅助 类 。 尤 其 是 ， 您 重 写 了 onCreate0 方 法 和 
onUpegrade() 777: 


private static class DatabaseHelper extends SQLiteOpenHelper 


{ 
DatabaseHelper (Context context) 
{ 
super (context, DATABASE NAME, null, DATABASE VERSION); 
} 
@Override 
public void onCreate (SQLiteDatabase db) 
{ 
try { 
db.execSQL (DATABASE CREATE); 
} catch (SQLException e) { 
e.print5tackTracertr): 
} 
} 
@Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int 
newVersion) 
{ 
Log.w(TAG, "Upgrading database from version"+oldVersion+"™ to " 
+newVersion + ", which will destroy all old data"); 
db.execSQL("DROP TABLE IF EXISTS contacts"); 
onCreate (db); 
} 
} 


onCreate0 方 法 在 所 需 数据 库 不 存在 时 创建 一 个 新 的 数据 库 。 onUpgrade0 方 法 在 数据 
库 需 要 升级 时 调用 。 这 可 以 通过 检查 在 DATABASE VERSION 常量 中 定义 的 值 来 实现 。 
对 于 onUpgrade() 方 法 的 这 一 实现 ， 只 是 删除 表 并 再 创建 它 。 

然后 ， 可 以 定义 用 于 打开 和 关闭 数据 库 的 不 同方 法 ， 以 及 用 于 在 表 中 添加 、 修 改 、 删 
除 行 的 方法 。 


//---opens the database--- 
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public DBAdapter open() throws SQLException 
{ 
db = DBHelper.getWritableDatabase(); 
return this; 


//---closes the database--- 
public void close() 


{ 
DBHelper.close(); 


//---insert a contact into the database--- 

public long insertContact(String name, String email) 

{ 
ContentValues initialValues = new ContentValues(); 
initialValues.put (KEY NAME, name); 
initialValues.put (KEY EMAIL, email); 
return db.insert (DATABASE TABLE, null, initialValues) ; 


//---deletes a particular contact--- 
public boolean deleteContact(long rowId) 


{ 
return db.delete (DATABASE TABLE, KEY ROWID + "=" + rowId, null) > 0; 


//---retrieves all the contacts--- 
public Cursor getAllContacts() 
{ 
return db. query (DATABASE TABLE, new String[] (KEY ROWID, KEY NAME, 
KEY EMAIL), null, null, null, null, null); 


//---retrieves a particular contact--- 
public Cursor getContact(long rowld) throws SQLException 
{ 
Cursor mCursor = 
db.query(true, DATABASE TABLE, new String[] {KEY ROWID, 
KEY NAME, KEY EMAIL], KEY ROWID + "=" + rowId, null, 
null, null, null, null); 
if (mCursor !- null) { 
mCursor.moveToFirst (); 
} 


return mCursor; 


//---updates a contact--- 
public boolean updateContact (long rowld, String name, String email) 


{ 
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ContentValues args = new ContentValues(); 

args.put(KEY NAME, name); 

args.put(KEY EMAIL, email); 

return db.update(DATABASE TABLE,args,KEY ROWID+"="+rowld,null)>0; 


注意 ，Android 使 用 Cursor 类 作为 查询 的 返回 值 。 可 以 将 Cursor 看 成 是 一 个 指 回 数 据 
库 查 询 的 结果 集 的 指针 。 使 用 Cursor 可 以 使 Android 更 有 效 地 按 需 要 管理 行 和 列 。 
使 用 ContentValues 对 象 来 存储 键 / 值 对 。 其 put0 方 法 可 用 于 插入 具有 不 同 数 据 类 型 值 
的 键 。 
为 了 使 用 DBAdapter 类 在 应 用 程序 中 创建 数据 库 ， 创 建 了 DBAdapter 类 的 一 个 实例 : 
public DBAdapter (Context ctx) 
| this.context = ctx; 
DBHelper = new DatabaseHelper (context) ; 
} 
SX if}, DBAdapter 类 的 构造 函数 创建 了 DatabaseHelper 类 的 一 个 实例 来 创建 一 个 新 的 
数据 库 : 
DatabaseHelper (Context context) 


{ 
super (context, DATABASE NAME, null, DATABASE VERSION); 
} 


6.3.2 ”以 编程 方式 使 用 数据 库 


创建 了 DBAdapter 辅助 关 后 ， 就 可 以 使 用 数据 库 了 。 在 下 面 的 小 节 中 ， 将 学 习 如 何 对 
数据 库 执 行 币 见 的 CRUD( 创 建 、 读 取 、 更 新 和 删除 ) 操 作 。 


1. 添加 联系 人 
下 向 的 “ 试 一 试 ”演示 了 如 何 将 一 个 联系 人 洪 加 a 到 表 中 。 


向 表 中 添加 联系 人 


Databases.zip fCfZ X fF AT UTE Wrox.com E FF 


(1) 打开 先前 创建 的 同一 个 项 目 , 在 DatabasesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 
i &): 


package net.learn2develop.Databases; 


import android.app.Activity; 
import android.os.Bundle; 
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public class DatabasesActivity extends Activity { 
/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


DBAdapter db = new DBAdapter (this) ; 


//---add a contact--- 


db.open(); 
long id - 
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db.insertContact("Wei-MengLee","weimenglee8learn2develop.net"); 


id = db.insertContact("Mary Jackson", 


db.close(); 


(2) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 


示例 说 明 


在 这 个 例子 中 ， 首 先 创 建 了 一 个 DBAdapter 类 的 实例 : 


DBAdapter db = new DBAdapter (this); 


"mary@jackson.com") ; 


insertContact0O) 方 法 返回 所 插入 行 的 IDP。 如 果 在 操作 中 发 生 错误 则 返回 -1 。 


如 果 使 用 DDMS 检 


下 创建 了 MyDB 数据 库 ( 如 图 6-16 所 示 )。 


C DDMS - Databazes/src/net/learn2develan/Databases/DatabasezActivity java - Eclipse 


t Android 设备 /模拟 器 的 文件 系统 ， 可 以 看 到 在 databases 文件 夹 
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2. 检索 所 有 联系 人 


为 了 检索 contacts 表 中 所 有 联系 人 ， 使 用 DBAdapter 类 的 getAllContacts0 方 法 ， 如 下 
而 的 “ 试 一 试 ” 所 示 。 


从 表 中 检索 所 有 联系 人 


_ Databases.zip PAIX PFH ULE Wrox.com E FÆ 


(1) 打开 先前 创建 的 同一 个 项 目 , 在 DatabasesActivity.java 文件 中 添加 下 列 粗 体 显示 的 


tA): 
package net.learn2develop. Databases; 


import android.app.Activity; 
import android.database.Cursor; 
import android.os.Bundle; 
import android.widget.Toast; 


public class DatabasesActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView (R.layout.main) ; 


DBAdapter db = new DBAdapter (this) ; 


"ES 
//---add a contact--- 
db.open(); 
db.close(); 

*/ 


//---get all contacts--- 
db.open(); 
Cursor c = db.getAllContacts(); 
if (c.moveToFirst()) 
{ 

do { 

DisplayContact (c); 

) while (c.moveToNext()); 
} 
db.close(); 


public void DisplayContact(Cursor c) 
i 
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Toast.makeText (this, 


"id: "+ c.getString(0) + "Mn" + 


"Name: "+ c.getString(1) + "Mn" + 
"Email: " + c.getString(2), 
Toast.LENGTH LONG) .show() ; 


} 

(2) T£ F11 键 在 Android 模拟 右上 调试 应 用 程序 。 图 
6-17 展示 了 了 Toast 类 所 显示 的 从 数据 库 中 检索 到 的 联系 人 。 

示例 说 明 

DBAdapter 类 的 getAllContacts0 方 法 检索 存储 于 数据 
库 中 的 所 有 联系 人 。 结 果 以 Cursor 对 象 的 形式 返回 。 为 了 
显示 所 有 联系 人 人， 首先 需要 调用 Cursor RN 
moveToFirstO 方 法 。 如 果 成 功 ( 这 意味 看 至 少 有 一 行 可 用 )， 
则 使 用 DisplayContactO 方 法 来 显示 该 联系 人 的 详细 信息 。 
要 移动 到 下 一 个 联系 人 ， 则 要 调用 Cursor X RN 
moveToNext() 77 17; . 


3. 检索 单个 联系 人 
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id: 7 


Name: Mary Jackson 
Email: mary@jackson.com 


6-17 


要 利用 联系 人 的 ID 来 检索 单个 联系 人 ， 可 按 下 面 的 “ 试 一 试 ” 所 展示 的 ， 调 用 


DBAdapter 类 的 getContact0 方 法 。 


从 表 中 检索 单个 联系 人 


Databases.zip (ÇX PFE DL f£ Wrox.com E FE 


(1) 打开 先前 创建 的 同一 个 项 目 , 在 DatabasesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 


语句: 


QOverride 


public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


DBAdapter db = new DBAdapter (this); 


/* 
//---add a contact--- 


//--get all contacts--- 


db.close(); 
ui 
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//---get a contact--- 

db.open(); 

Cursor c = db.getContact (2); 

if (c.moveToFirst()) 
DisplayContact (c); 

else 
Toast.makeText(this, "No contact found", Toast. LENGTH LONG). 
show () ; 

db.close(); 

} 


(2) TZ F11 BE Android 模拟 器 上 调试 应 用 程序 。 第 二 个 联系 人 的 详细 信息 将 通过 Toast 
类 显示 出 来 。 

示例 说 了 明 

DBAdapter 类 的 getContact0 方 法 使 用 联系 人 的 D 来 检索 单个 联系 人 。 传 入 联系 人 的 
ID; 这 里 传 入 的 ID 是 2， 表 明 想 要 检索 第 二 个 联系 人 : 


Cursor c = db.getContact (2); 


结果 以 Cursor 对 和 象 的 形式 返回 。 如果 返回 了 一 行 , 就 使 用 DisplayContactO 方 法 来 显示 
联系 人 的 详细 信息 ; 否则 使 用 Toast Z5 zn — ATH Re 


4. 更 新 联系 人 


通过 调用 DBAdapter 类 的 updateContactO 方 法 并 传递 一 个 想 要 更 新 的 联系 人 的 ID， 可 
以 实现 对 某 个 特定 联系 人 的 更 新 操作 ， 如 下 面 的 “ 试 一 试 ” 所 示 。 


Se | 更 新 表 中 某 个 联系 人 


Databases.zip (HX fF uJ LUTE Wrox.com E FE 


(1) 打开 先前 创建 的 同一 个 项 目 , 在 DatabasesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 
语句 : 


@Override 

public void onCreate (Bundle savedInstanceState) | 
super.onCreate(savedInstanceState); 
setContentView (R.layout.main) ; 


DBAdapter db = new DBAdapter (this) ; 


/* 
//---add a contact--- 


//--get all contacts--- 
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//---get a contact--- 


db.close(); 
*/ 


//---update contact--- 
db.open(); 
if (db.updateContact(1, "Wei-Meng Lee", "weimenglee@gmail.com") ) 
Toast.makeText(this, "Update successful.", 
Toast.LENGTH LONG).show(); 
else 
Toast.makeText(this, "Update failed.", Toast.LENGTH LONG). 
show () ; 
db.close(); 


} 
(2) f£ F11 键 在 Android 模拟 嚣 上 调试 应 用 程序 。 如 果 更 新 成 功 ， 将 显示 一 条 消 奶 。 
示例 说 明 


DBAdapter 类 中 的 updateContactO 方 法 利用 您 打算 更 新 的 联系 人 的 卫 来 更 新 此 联系 人 
的 详细 信息 。 它 返回 一 个 Boolean 值 ， 表 明 更 新 是 否 成 功 。 


5. 删除 一 个 联系 人 


使 用 DBAdapter 类 的 deleteContactO 方 法 并 传递 一 个 想 要 删除 的 联系 人 的 了， 可 以 实 
现 对 某 个 联系 人 的 删除 操作 ， 如 下 面 的 “ 试 一 试 ” 所 示 。 


删除 表 中 的 某 个 联系 人 


Databases.zip fCfg X PFP BUTE Wrox.com E FE 


(1) 打开 先前 创建 的 同一 个 项 目 , YE DatabasesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 
语句 : 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView(R.layout.main); 


DBAdapter db = new DBAdapter (this); 


/* 
//---add a contact--- 


//--get all contacts--- 
//---get a contact--- 


//---update contact--- 
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db.close(); 
ui 


//---delete a contact--- 
db.open(); 
1f (db.deleteContact(1)) 
Toast.makeText (this, "Delete 
successful.",Toast.LENGTH LONG). 
show (); 
else 
Toast.makeText(this, "Delete failed.", Toast.LENGTH LONG). 
show (); 
db.close(); 


(2) FX F11 键 在 Android faq at FAY REAP GRR a, Tho RA 
示例 说 明 


DBAdapter 类 中 的 deleteContactO 方 法 利用 您 打算 删除 的 联系 人 的 ID 来 删除 此 联系 人 。 
它 返 回 一 个 Boolean 值 ， 表 明 删 除 是 否 成 功 。 


6. 升级 数据 库 


有 时 ,在 创建 和 开始 使 用 数据 库 之 后 ， 您 可 能 外 要 添加 另外 的 表 、 改 变数 据 库 的 模式 ， 
或 者 在 表 中 添加 一 些 列 。 这 时 ， 就 再 要 将 旧 数 据 库 中 现 有 的 数据 迁移 到 一 个 新 数据 库 中 。 
要 升级 数据 库 ， 再 要 将 DATABASE VERSION 常量 改 为 比 先前 要 高 的 值 。 例 如， 如 果 
先前 的 值 是 1， 则 现在 改 为 2: 
public class DBAdapter | 
static final String KEY ROWID = " id"; 
static final String KEY NAME - "name"; 


static final String KEY EMAIL - "email"; 
static final String TAG = "DBAdapter"; 


static final String DATABASE NAME = "MyDB"; 


static final String DATABASE TABLE = "contacts"; 
static final int DATABASE VERSION - 2; 


注意 : 在 运行 这 个 示例 之 前 ， 一 定 要 注释 掉 前 一 小 节 中 介绍 的 删除 语句 块 。 ES 
则 ， 因 为 数据 库 中 的 表 将 被 删除 ， 删 除 操作 会 失败 。 


当 再 一 次 运行 应 用 程序 时 ， 在 Eclipse 的 LogCat 窗口 中 可 以 看 到 以 下 消息 : 


DBAdapter (8/05): Upgrading database from version 1 to 2, which 
will destroy all old data 
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在 这 一 例子 中 ， 为 简单 起 见 ， 直 接 删除 现 有 的 表 并 创建 一 个 新 表 。 在 实际 中 ， 通 第 需 
要 备份 现 有 的 表 ， 然 后 将 其 内 容 复 制 到 新 表 中 。 
6.3.3” 预 创建 数据 库 
在 实际 的 应 用 中 ， 有 时 在 设计 时 预 创建 数据 库 要 比 在 运行 时 创建 更 有 效 。 例 如 ， 您 可 


能 想 创 建 一 个 应 用 程序 来 记录 所 有 目 己 去 过 的 地 方 的 坐标 。 此 时 , 在 设计 时 预 创建 数据 库 ， 
然后 在 运行 时 使 用 这 个 数据 库 会 简单 得 多 。 


工具 就 是 SQLite Database Browser， 其 对 于 不 同 的 平台 都 是 免费 可 用 的 (http:/sourceforgenet/ 
projects/sqlitebrowser/). 
一 日 安装 SQLite Database Browser, 就 可 以 用 可 视 化 方式 来 创建 一 个 数据 库 。 图 6-18 
展示 了 已 经 创建 好 一 个 指明 了 字段 的 contacts 表 。 
E3 SQLite Database Browser - C:\Users\Wei-Meng Lee\Desktop\mydb 
File Edit View Help 
«Du bl | p gy tet E)? 


| Database Structure | BrowseData | SQL. | 


| Schema 
CREATE TABLE contacts (. id INTEGER PRIMARY KEY, name TEXT, email TEXT) 


图 6-18 
用 行 填充 表 也 很 简单 。 图 6-19 展示 了 如 何 使 用 Browse Data 选项 卡 来 为 表 填 充 数据 。 
E SQLite Database Browser - C:\Users\Wei-Meng Lee\Desktop\mydb EXE" 


File Edit View Help 
ug Ged o mi c ee Ei | ES | o? 


| Database Structure | Browse Data | Execute SQL 


we (a x) 四 [717730771770 
id name | 


email | | 


1 Wei-Meng Lee _weimenglee &gmail. 
eum Jackson mary @jackson.com 


图 6-19 
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在 设计 时 创建 了 数据 库 后 ， 下 一 步 要 做 的 就 是 将 其 与 应 用 程序 捆绑 ， 这 样 就 可 以 在 应 
用 程序 中 使 用 数据 库 了 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 捆绑 。 
押 绑 一 个 数据 库 

(1) 使 用 先前 创建 的 同一 个 项 目 ， 将 在 前 一 节 中 创建 的 SQLite 数据 库 文件 拖 放 到 
Eclipse 中 Android 项 目的 assets 文件 夹 下 (如 图 6-20 所 示 )。 


a S. Databases 
4 Z src 
4 BH net.learn2develop.Databases 
. |J] DatabasesActivity.java 
> [À DBAdapter.java 
> i38 gen [Generated Java Files] 
> BA Android 4.0 


aa assets 


|j mydb 
» > bin 
, d» res 
X1 AndroidManifest.xml 
E| proguard.cfq 
|=) project.properties 


图 6-20 


注意 : 添加 到 assets 文件 夹 下 的 文件 名 必须 采用 小 写字 母 格 式 。 因 此 , 像 MyDB 
这 样 的 文件 名 是 无 效 的 ， 而 mydb 是 可 以 的 。 


(2) 在 DatabasesActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 
package net.learn2develop.Databases; 


import java.io.File; 

import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io.IOException; 

import java.io.InputStream; 

import java.io.OutputStream; 


import android.app.Activity; 
import android.database.Cursor; 
import android.os.Bundle; 
import android.widget.Toast; 


public class DatabasesActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


DBAdapter db = new DBAdapter(this); 
try 1 
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String destPath = "/data/data/" + getPackageName() + 
"/databases"; 

File f = new File(destPath) ; 

if ('f.exists()) { 
f.mkdirs(); 
f.createNewFile(); 


//---copy the db from the assets folder into 
// the databases folder--- 
CopyDB(getBaseContext().getAssets().open("mydb"), 
new FileOutputStream(destPath + "/MyDB")); 
} 
} catch (FileNotFoundException e) { 
e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 


//---get all contacts--- 
db.open(); 
Cursor c = db.getAllContacts(); 
if (c.moveToFirst()) 
i 

do { 

DisplayContact(c); 

} while (c.moveToNext()); 
} 
db.close(); 


public void CopyDB(InputStream inputStream, 
OutputStream outputStream) throws IOException { 

//---copy 1K bytes at a time--- 

byte[] buffer = new byte[1024]; 

int length; 

while ((length = inputStream.read(buffer)) > 0) { 

outputStream.write (buffer, 0, length); 

} 

inputStream.close(); 

outputStream.close(); 


public void DisplayContact(Cursor c) 
{ 


Toast.makeText (this, 


"id: " + e.getString(0) + "Vn" + 
"Name: " + c.getString(1) + "\n" + 
"Emails: ”+ c.getString (2), 


Toast. LENGTH LONG) .show(); 
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(3) f£ F11 BEE Android 模拟 器 上 调试 应 用 程序 。 当 应 用 程序 运行 时 ， 它 将 把 mydb 数 
据 库 文件 以 MyDB 为 名 复制 到 /data/datammetlearn2develop.Databases/databases/ 文 件 夹 下 。 

示例 说 明 

首先 将 CopyDB(0) 方 法 定义 为 将 数据 库 文 件 从 一 处 复制 到 另 一 处 : 


public void CopyDB (InputStream inputStream, 
OutputStream outputStream) throws IOException { 

//-—--copy 1K bytes at a time--- 

byte[] buffer = new byte[1024]; 

int length; 

while ((length = inputStream.read(buffer)) > 0) { 

outputStream.write (buffer, 0, length); 

} 

inputStream.close(); 

outputStream.close(); 


} 


注意 ， 在 这 种 情况 下 ， 使 用 InputStream 对 象 来 从 源 文件 中 读 取 数据 ， 然 后 使 用 
OutputStream 对 象 将 其 写 入 到 目标 文件 中 。 

当 活 动 被 创建 时 , 将 位 于 assets 文件 夹 下 的 数据 库 文 件 复 制 到 Android 设备 (或 模拟 右 ) 
上 的 /dataydatamet.learn2develop.Databases/databases/ 文 件 严 下 : 


try { 
String destPath = "/data/data/" + getPackageName() + 
"/databases"; 
File f = new File (destPath) ; 
if ('f.exists()) { 
f.mkdirs (); 
f.createNewFile(); 


//---copy the db from the assets folder into 
// the databases folder--- 
CopyDB (getBaseContext ().getAssets ().open("mydb"), 
new FileOutputStream(destPath + "/MyDB")); 
} 
} catch (FileNotFoundException e) { 
e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
只 有 在 目标 文件 夹 下 不 存在 数据 库 文件 时 才 执 行 复制 操作 。 如 果 不 进行 这 一 检查 ， 每 
一 次 创建 活动 时 ， 数据库 文 件 将 被 assets 文件 夹 下 的 文件 所 窗 盖 。 这 也 许 是 您 所 不 布 望 的 ， 
因为 应 用 程序 在 运行 时 很 可 能 会 对 数据 库 文 件 做 修改 ， 这 将 消除 到 目前 为 止 您 对 数据 库 所 


做 出 的 一 切 改变 。 
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为 了 确保 数据 库 文 件 的 确 被 复制 了 ， 在 测试 应 用 程序 之 前 要 确保 在 模拟 器 中 删除 了 数 
据 库 文件 (如 果 还 存在 的 话 )。 可 以 使 用 DDMS 来 删除 数据 库 ( 如 图 6-21 所 示 )。 


us DDMS - Databases/src/net/leamrnzdevelop/Databases/DatabasesActivity.java - Eclipse 
File Edit Run ‘Source Navigate Search Project Refactor Window Help 


pr 2 


Sov-~ PvE "有 "如 rr 


B Devices 25, —H $, Thread: | 目 Heap | @ Allocation Tracker | File Explorer £3 > 


| | o B | x 3 ma Name Size 
Mame (= com.example.android.softkeyboard 
a emulsigr-5554 (> com.moterola.pgmsystem 
system process i (= com.motorola.programmenu 
com.android.systemul 
com.android.phone 
com.android.launcher 


(> com.svox.pico 

(= jp.co.omronsoft.openwnn 
(> net.earn?develop.ActrvitylUl 
(= net.learn?2develop.Databases 
a (oy databases 


com.android.calendar 
android. process.acore 
com.android.deskclock DATA. 
com.android.providers.calendar E ik i 
comandroid settings P & lib 
com.android.contacts eme eec su 
4 | —  —mÀ -— 5 [EE net.learn2develop.Emails 
as E net.learn2develop.Files 
@ Emulator Control H ~ (= netlearn2develop.HelloWorld 


i mE PR 


(= net.learn?develop.J5ON 
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在 本 章 中 ， 我 们 学 习 了 将 持久 性 数据 保存 在 Android 设备 中 的 不 同方 法 。 对 于 简单 的 
非 结 构 化 数据 ， 使 用 SharedPreferences 对 象 是 一 个 理想 的 方案 。 如 果 需 要 存储 批量 数据 ， 
可 以 考虑 使 用 传统 的 文件 系统 。 最 后 ， 对 于 结构 化 数据 ， 在 关系 数据 库 管 理 系统 中 进行 存 
储 会 更 有 效率 。 为 此 ，Android 提供 了 可 以 利用 公开 的 API 轻松 访问 的 SQLite 数据 库 。 


注意 ， 对 于 SharedPreferences 对 象 和 SQLite 数据 库 来 说 ， 数 据 只 能 被 创建 它 的 应 用 程 
序 访 问 。 换 名 话说 ， 它 是 不 可 共享 的 。 如 果 需 要 在 不 同 应 用 程序 之 间 共 享 数据 ， 则 要 创建 


-个 内 容 提供 者 (content provider). 38 7 章 将 详细 讨论 内 容 提供 者 。 


1. 如 何 使 用 活动 显示 应 用 程序 的 首选 项 ? 
2. 说 出 能 够 获取 Android 设备 的 外 部 存储 器 的 路 径 的 方法 。 


3. 当 向 外 部 存储 器 写 入 文件 时 需要 声明 什么 权限 ? 
练习 答案 参见 附录 C。 


本 章 主 要 内 容 


E om 关键 概念 


保存 简单 的 用 户 数据 使 用 SharedPreferences 对 向 


在 同一 应 用 程序 的 活动 之 间 共 圣 数 据 使 用 getSharedPreferences0 方 法 


保存 到 文件 使 用 FileOutputStream 和 OutputStreamReader 类 
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( 续 表 ) 
r a 关键 概念 

WX TF 使 用 FileInputStream 和 InputStreamReader 类 

保存 到 外 部 存储 器 使 用 getExternalStorageDirectory0 方 法 返回 指 同 外 部 存 
储 器 的 路 径 

访问 位 于 res/raw 文件 夹 下 的 文件 {RAI Resources XY — getResources0 方 法 获得 ) 的 
openRawResource() 77 1X: 

创建 数据 库 辅 助 类 扩展 SQLiteOpenHelper 类 


Ts 


内 容 提 供 者 


本 章 将 介绍 以 下 内 容 : 

e 内 容 提 供 者 简介 

e 如 何在 Android 中 使 用 内 容 提供 者 
e 如 何 创 建 和 使 用 自己 的 内 容 提供 者 


在 第 6 章 中 ， 我 们 学 习 了 持久 化 数据 的 不 同方 法 一 一 使 用 共享 首选 项 、 文 件 系统 以 及 
SQLite 数据 库 。 虽 然 使 用 数据 库 方法 来 保存 结构 化 的 复杂 数据 是 值得 推荐 的 方式 ， 但 数据 
共 至 是 一 个 挑战 ， 因 为 数据 库 只 能 被 创建 它 的 包 访 问 。 

我 们 将 在 本 章 学 习 Android 通过 使 用 内 容 提供 者 来 共享 数据 的 方法 。 您 将 学 习 到 如 何 
使 用 内 置 的 内 容 提供 者 以 及 通过 实现 目 己 的 内 容 提供 者 来 跨 包 共享 数据 。 


7.4 在 Android 中 共享 数据 


在 Android 中 ， 推 荐 使 用 内 容 提供 者 来 实现 跨 包 的 数据 共享 。 可 以 将 内 容 提 供 者 视 为 
种 数据 存储 。 它 存储 数据 的 方式 和 使 用 它 的 应 用 程序 无 关 ， 重 要 的 是 包 如 何以 一 致 的 编 
程 接口 来 访问 存储 其 中 的 数据 。 内 容 提供 者 的 行为 方式 与 数据 库 很 像 一 一 您 可 以 查询 它 ， 
编辑 以 及 增加 或 删除 其 内 容 。 然 而 ， 与 数据 库 不 同 的 是 ， 内 容 提 供 者 可 以 使 用 不 同 的 方式 
来 存储 数据 。 数 据 可 以 存储 于 数据 库 、 文 件 中 甚至 网 络 上 。 

Android 附带 了 许多 有 用 的 内 容 提 供 者 ， 包 括 : 

e Browsel 一 一 存储 诸如 浏览 器 书签 、 浏 览 器 历史 记录 等 数据 

e CallLog 一 一 存储 诸如 未 接 电话 、 通 话 详细 信息 等 数据 
存储 联系 人 详细 信息 
e MediaStore 一 一 存储 媒体 文件 ， 如 音频 、 视 频 和 图 像 
e Settings 一 一 存储 设备 的 设置 和 首选 项 
除了 一 些 内 置 的 内 容 提 供 者 以 外 ， 还 可 以 创建 自己 的 内 容 提供 者 。 


e Contacts 
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为 了 查询 内 容 提 供 者 ， 可 为 特定 行使 用 一 个 可 选 的 说 明 符 ， 以 URI 形式 指定 查询 字符 
串 。 查 询 URI 的 格式 如 下 所 示 : 


<standard prefix>://<authority>/<data path>/<id> 


URI 的 不 同 部 分 如 下 所 示 : 

e 内 容 提 供 者 的 standard prefix 始终 是 content://. 

e authority 指定 了 内 容 提供 者 的 名 称 ， 如 内 置 的 Contacts 内 容 提 供 者 的 名 称 为 
contacts 。 对 于 第 三 方 内 容 提 供 者 ， 将 采用 完全 限定 的 名 称 ， 如 com.wrox.provider 
或 者 net.learn2develop.provider. 

e data path 指定 了 请 求 数据 的 类 型 。 例 如 ， 如 果 您 是 从 Contacts 内 容 提供 者 获取 所 有 
联系 人 人， 那么 data path 就 是 people, mi URI 为 content://contacts/people。 

e id 指定 了 请 求 的 特定 记录 。 例 如 , 如 果 您 从 Contacts 内 容 提供 者 中 查找 2 与 联系 人 ， 
那么 URI A content://contacts/people/2 . 

表 7-1 列 出 了 一 些 碍 询 字 符 串 的 示例 。 


表 7-1 查询 字符 串 的 示例 


查询 字符 串 |: — x 
content://media/internal/images 返回 一 个 存储 在 设备 上 的 所 有 内 部 图 像 的 列表 
| 返回 一 个 存储 在 设备 的 外 部 存储 器 (如 SD 卡 ) 上 
content://media/external/images | 
的 所 有 图 像 的 列表 
content://call log/calls 返回 一 个 在 CallLog 中 记录 的 所 有 通话 的 列表 
content://browser/bookmarks 返回 一 个 存储 在 浏览 器 中 的 书签 列表 


7.2 使 用 内 容 提 供 者 


理解 内 容 提 供 者 的 最 佳 方法 就 是 实际 地 运用 它 。 下 面 的 “ 试 一 试 ”展示 了 在 Android 
应 用 程序 中 如 何 使 用 内 容 提 供 者 。 


使 用 Contacts 内 容 提供 者 
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Provider.zip (CHI X fF ATLA f£ Wrox.com E FE 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 命 名 为 Provider. 
(2) 在 main.xml 文件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 
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<ListView 
android: id="@+id/android:list" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: layout weight="1" 
android: stackFromBottom="false" 
android: transcriptMode="normal" /> 


<TextView 
android: id="@+id/contactName" 
android: textStyle="bold" 
android: layout width="wrap content" 
android: layout height-"wrap content" /> 


<TextView 
android: id="@+id/contactID" 
android: layout width-"fill parent" 
android: layout height="wrap content" /> 


</LinearLayout> 


(3) 在 ProviderActivityjava 类 中 编写 如 下 代码 : 


package net.learn2develop.Provider; 


import android.app.ListActivity; 

import android.content.CursorLoader; 
import android.database.Cursor; 

import android.net.Uri; 

import android.os.Bundle; 

import android.provider.ContactsContract; 
import android.widget.CursorAdapter; 
import android.widget.SimpleCursorAdapter; 


public class ProviderActivity extends ListActivity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


Uri allContacts = Uri.parse("content://contacts/people"); 


Cursor c; 
if (android.os.Build.VERSION.SDK INT <11) { 

//---before Honeycomb--- 

c = managedQuery(allContacts, null, null, null, null); 
} else { 

//---Honeycomb and later--- 

CursorLoader cursorLoader = new CursorLoader ( 
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c= 


String [] 


this, 
allContacts, 
null, 

null, 

null , 
null); 


cursorLoader.loadInBackground(); 


columns = new String[] { 


ContactsContract.Contacts.DISPLAY NAME, 
ContactsContract.Contacts. ID]; 


int[] views = new int[] {R.id.contactName, R.id.contactID}; 


SimpleCursorAdapter adapter; 


if (android.os.Build.VERSION.SDK INT <11) 1 
//---before Honeycomb--- 
adapter = new SimpleCursorAdapter ( 


} else { 


this, R.layout.main, c, columns, views); 


//---Honeycomb and later--- 
adapter = new SimpleCursorAdapter( 


this, R.layout.main, c, columns, views, 
CursorAdapter.FLAG REGISTER CONTENT OBSERVER); 


this.setListAdapter (adapter); ] 


} 


(4) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"l. 


0" encoding="utf-8"?> 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net 


.learn2develop.Provider" 


android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
«uses-permission android:name-"android.permission.READ CONTACTS"/> 


«application 


android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

«activity 
android:label-"8string/app name" 
android:name-".ProviderActivity" > 
«intent-filter > 


«action android:name-"android.intent.action.MAIN" /» 


«category android:name="android.intent.category.LAUNCHER"/> 


«/intent-filter-» 
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</activity> 
</application> 


</manifest> 


(5) 启动 一 个 AVD 并 在 Android 模拟 器 中 创建 一 些 联系 人 。 要 添加 联系 人 ,进入 Phone 
应 用 程序 ， 单 击 项 部 的 星 型 图 标 ， 如 图 7-1 所 示 。 单 击 模拟 器 的 MENU 按钮 ， 然 后 单 击 
New contact 菜单 项 。 模 拟 器 将 提醒 备份 联系 人 。 单 击 Keep Local 按钮 ， 然 后 输入 几 个 人 
的 姓名 、 电 话 号 码 和 电子 邮件 地 址 。 

(6) TZ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 图 7-2 展示 了 活动 显示 刚刚 创建 的 联 
系 人 列表 。 


z 
F al H 
B^ 5554Jbndacid dU 8»  555d:AÀndrmid A0 


e 


ALL CONTACTS WITH PHONE NUMBERS 


- Provider 


Wei-Meng Lee 
| 


Linda Chen 


Joanna Yip 


Contacts to display 
New contact 


Settings 


图 7-1 图 7-2 
示例 说 明 
在 这 一 示例 中 ,检索 所 有 存储 在 Contacts 应 用 程序 中 的 联系 人 并 在 ListView 中 进行 显示 。 
首先 ， 指 定 了 访问 Contacts 应 用 程序 的 URI: 


Uri allContacts = Uri.parse("content://contacts/people"); 


A FAAS aR PP HE CORTE Tis FT DY, FEY 15 f S CAS : 


Cursor c; 
if (android.os.Build.VERSION.SDK INT «11) { 

/ / ---before Honeycomb--- 

c = managedQuery(allContacts, null, null, null, null); 
} else { 

//---Honeycomb and later--- 

CursorLoader cursorLoader = new CursorLoader ( 
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this, 
allContacts, 
null, 
null, 
null , 
null); 
C — cursorLoader.loadInBackground(); 


| 


如 果 应 用 程序 运行 在 早 于 Honeycomb Hik% E(android.os.Build. VERSION.SDK INT 
变量 的 值 小 于 11)， 那 么 可 以 使 用 Activity 类 的 managedQuery0 方 法 来 检索 一 个 托管 游标 。 
托管 游标 处 理 在 应 用 程序 暂停 时 和 凶 载 其 目 身 和 在 应 用 程序 重启 时 重新 伍 询 目 身 的 所 有 工 
作 。 语 句 : 


Cursor c = managedQuery(allContacts, null, null, null, null); 


等 价 于 : 


Cursor c-getContentResolver().query(allContacts,null,null,null,null); 
//---allows the activity to manage the Cursor's 

// lifecyle based on the activity's lifecycle--- 
startManagingCursor (c); 


getContentResolver0 方 法 返回 一 个 ContentResolver 对 象 ， 它 可 以 使 用 合适 的 内 容 提 供 
者 来 帮助 解析 内 容 URI。 
但 是 ， 从 Android API 级 别 11 开始 (Honeycomb 及 更 高 版 本 )，manageQuery0 方 法 被 工 
用 了 (仍然 可 以 使 用 ， 但 是 不 建议 这 么 做 )。 对 于 运行 Honeycomb 或 更 高 版 本 的 设备 ， 应 该 
使 用 CursorLoader 类 : 
CursorLoader cursorLoader = new CursorLoader ( 
this, 
allContacts, 
null, 
null, 
null , 
null); 
c = cursorLoader.loadInBackground(); 


CursorLoader 类 (从 Android API 级 别 11 才 开 始 可 用 ) 在 后 台 线 程 中 执行 游标 得 询 ， 因 
此 不 会 阻塞 应 用 程序 的 用 户 界 面 。 
SimpleCursorAdapter 对 和 象 将 一 个 游标 映射 到 在 XML 文件 (main.xmD) 中 定义 的 TextView 
(或 者 ImageView)， 并 将 数据 (由 columns 表示 ) 映 射 到 视图 (由 views 表示 ) 上 : 
String[] columns = new String[] { 


ContactsContract.Contacts.DISPLAY NAME, 
ContactsContract.Contacts. ID}; 


int[] views = new int[] {R.id.contactName, R.id.contactID}; 
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SimpleCursorAdapter adapter; 


if (android.os.Build.VERSION.SDK INT <11} { 
//---before Honeycomb--- 
adapter = new SimpleCursorAdapter( 
this, R.layout.main, c, columns, views); 
} else { 
//---Honeycomb and later--- 
adapter = new SimpleCursorAdapter( 
this, R.layout.main, c, columns, views, 
CursorAdapter.FLAG REGISTER CONTENT OBSERVER); 
} 


this.setListAdapter (adapter) ; 
Ej managedQuery() 7; IEŽA, SimpleCursorAdapter 类 的 一 个 构造 函数 已 被 弃 用 。 对 于 


Honeycomb 及 更 高 版 本 的 设备 ， 震 要 使 用 SimpleCursorAdapter 类 的 一 个 新 构造 函数 ， 它 种 
有 一 个 额外 的 参数 : 


//---Honeycomb and later--- 

adapter = new SimpleCursorAdapter ( 
this, R.layout.main, c, columns, views, 
CursorAdapter.FLAG REGISTER CONTENT OBSERVER) ; 


这 个 标志 注册 了 当 内 容 提 供 者 中 发 生 更 改 时 所 通知 的 适配器 。 

注意 ， 为 了 使 应 用 程序 可 以 访问 Contacts 程序 ， 需 要 在 AndroidManifest xml 文件 中 有 
READ CONTACTS 权限 。 
7.2.1 预定 义 查询 字符 串 常量 


除了 使 用 查询 URI， 还 可 以 利用 Android 中 的 一 个 预定 义 碍 询 字 符 串 常量 的 列表 来 为 
不 同 数据 类 型 指定 URI. 例如 , 除了 使 用 查询 content://contacts/people, 还 可 以 使 用 Android 
中 的 一 个 预定 义 常 量 将 以 下 语句 : 


Uri allContacts = Uri.parse("content://contacts/people"); 


Uri allContacts = ContactsContract.Contacts.CONTENT URI; 


注意 : 对 于 Android 2.0 或 更 高 版 本 ， 需 要 使 用 ContactsContract.Contacts. 
CONTENT _URI 这 个 URI 来 查询 基本 的 Contacts 记录 。 


以 下 是 一 些 预 定义 得 询 字 符 串 第 量 的 示例 : 
e Browser.BOOKMARKS URI 
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e Browser.SEARCHES URI 

e CallLog.CONTENT URI 

e MediaStore.Images.Media.INTERNAL CONTENT URI 

e MediaStore.Images.Media.EXTERNAL CONTENT URI 

e Settings CONTENT URI 

如 果 想 要 检索 第 一 个 联系 人 ， 则 可 按 如 下 方式 指定 此 联系 人 的 ID: 


Uri allContacts = Uri.parse("content://contacts/people/1"); 


或 者 ， 可 以 结合 ContentUris 类 的 withAppendedId()7; 14:oK fii H] ig X 55$ 8 
import android.content.ContentUris; 


Uri allContacts = ContentUris.withAppendedId ( 
ContactsContract.Contacts.CONTENT URI, 1); 


除了 绑 定 到 ListView, oJ LEH Cursor 对 象 将 结果 输出 来 ， 如 下 所 示 : 


package net.learn2develop. Provider; 


import android.app.ListActivity; 
import android.content.CursorLoader; 
import android.database.Cursor; 
import android.net.Uri; 
import android.os.Bundle; 
import android.provider.ContactsContract; 
import android.widget.CursorAdapter; 
import android.widget.SimpleCursorAdapter; 
import android.util.Log; 
public class ProviderActivity extends ListActivity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


Uri allContacts = ContactsContract.Contacts.CONTENT URI; 


-_ -» H 


if (android.os.Build.VERSION.SDK INT «11) { 
//---before Honeycomb--- 
adapter = new SimpleCursorAdapter ( 
this, R.layout.main, c, columns, views); 
} else { 
//---Honeycomb and later--- 
adapter = new SimpleCursorAdapter ( 
this, R.layout.main, c, columns, views, 
CursorAdapter.FLAG REGISTER CONTENT OBSERVER) ; 
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this.setListAdapter (adapter); 
PrintContacts (c); 


private void PrintContacts(Cursor c) 


i 
if (c.moveToFirst()) { 
do { 
String contactID = c.getString(c.getColumnIindex ( 
ContactsContract.Contacts. ID)); 
String contactDisplayName = 
c.getString (c.getColumnIndex ( 
ContactsContract.Contacts.DISPLAY NAME) ) ; 
Log.v("Content Providers", contactID + ", " + 
contactDisplayName) ; 
} while (c.moveToNext()); 
} 
} 


( 注意 : 如 果 对 如 何 查看 LogCat 窗口 不 太 熟悉 ， 可 参阅 附录 A 快速 了 解 一 下 
Eclipse IDE. 


PrintContacts(0) 方 法 将 在 LogCat 窗口 中 输出 如 下 内 容 : 


12-13 08:32:50.471: V/Content Providers (12346): 1, Wei-Meng Lee 
12-13 08:32:50.471: V/Content Providers (12346): 2, Linda Chen 
12-13 08:32:50.471: V/Content Providers (12346): 3, Joanna Yip 

它 输出 了 存储 在 Contacts 应 用 程序 中 的 每 一 个 联系 人 的 ID 和 姓名 。 这 时 ,通过 访问 
ContactsContract.Contacts. ID 字段 来 获取 联系 人 的 ID， 访 问 ContactsContract.Contacts. 
DISPLAY NAME 来 得 到 联系 人 的 姓名 。 如 果 想 显示 联系 人 的 电话 号 码 ， 由 于 这 个 信息 存 
储 于 另外 一 张 表 中 ， 因 此 需要 再 次 查询 内 容 提供 者 : 


private void PrintContacts(Cursor c) 
{ 
if (c.moveToFirst()) { 
do 1 
String contactID = c.getString(c.getColumnIndex( 
ContactsContract.Contacts. ID)); 
String contactDisplayName = 
c.getString(c.getColumnIndex( 
ContactsContract.Contacts.DISPLAY 
NAME) ) ; 
Log.v ("Content Providers”, contactID +", * + 
contactDisplayName) ; 
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//---get phone number--- 
int hasPhone = 
c.getint (c.getColumnindex ( 
ContactsContract.Contacts.HAS PHONE | 
NUMBER) ) ; 
if (hasPhone == 1) { 
Cursor phoneCursor = 
getContentResolver().query( 
ContactsContract.CommonDataKinds.Phone. 
CONTENT URI, null, 
ContactsContract.CommonDataKinds.Phone.CONTACT 
D+ "=" + 
contactID, null, null); 
while (phoneCursor.moveToNext()) { 
Log.v("Content Providers", 
phoneCursor.getString( 
phoneCursor.getColumnIndex( 
ContactsContract.CommonDataKinds. 
Phone.NUMBER))); 
} 


phoneCursor.close() ; 


} while (c.moveToNext ()); 


注意 : 为 了 访问 一 个 联系 人 的 电话 号 码 ， 需 要 对 存储 于 ContactsContract. Common 
DataKinds.Phone.CONTENT URI 中 的 URI 进行 查询 。 


在 上 面 的 代码 片段 中 ， 首 先 使 用 ContactsContract.Contacts.HAS PHONE NUMBER 字 
段 检查 一 个 联系 人 是 否 有 电话 号 码 。 如 果 其 至 少 有 一 个 电话 号 码 ， 就 可 以 基于 此 联系 人 的 
ID 对 内 容 提 供 者 再 次 查询 。 一 旦 检索 到 这 一 ( 些 ) 号 码 ， 就 可 以 迄 代 人 遍历 并 把 它们 输出 来 。 
应 有 如 下 显示 内 容 : 

12-13 08:59:31.881: V/Content Providers (13351): 1, Wei-Meng Lee 

12-13 08:59:32.311: V/Content Providers (13351): +651234567 

12-13 08:59:32.321: V/Content Providers (13351): 2, Linda Chen 

12-13 08:59:32.511: V/Content Providers (13351): +1 876-543-21 


12-13 08:59:32.545: V/Content Providers (13351): 3, Joanna Yip 
12-13 08:59:32.641: V/Content Providers (13351): +239 846 5522 


7.2.2 投影 


managedQuery0 方 法 的 第 2 个 参数 (CursorLoader 类 的 第 3 个 参数 ) 控 制 查询 返回 的 列 
数 。 这 个 参数 被 称 为 投影 (projection)， 之 前 将 其 指定 为 null; 
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Cursor c; 
if (android.os.Build.VERSION.SDK INT «11) { 
//---before Honeycomb--- 
C — managedQuery(allContacts, null, null, null, null); 
} else { 
//---Honeycomb and later--- 
CursorLoader cursorLoader = new CursorLoader ( 
this, 
allContacts, 
null, 
null, 
null , 
null); 
C — cursorLoader.loadInBackground(); 


} 
nf RTE EE — Aa E BEL) A) BZ OR Ee R AWA, A P Hr: 


String[] projection = new String[] 
{ContactsContract.Contacts. ID, 
ContactsContract.Contacts.DISPLAY NAME, 
ContactsContract.Contacts.HAS PHONE NUMBER]; 


Cursor c; 
if (android.os.Build.VERSION.SDK INT «11) { 
//---before Honeycomb--- 
c — managedQuery(allContacts, projection, null, null, null); 
} else { 
//---Honeycomb and later--- 
CursorLoader cursorLoader = new CursorLoader ( 
this, 
allContacts, 
projection, 
null, 
null , 
null); 
C — cursorLoader.loadInBackground(); 


} 
在 上 述 情 况 下 ，ID、DISPLAY_NAME 以 及 HAS PHONE NUMBER 字段 都 将 被 检索 。 
7.2.3 ”筛选 
managedQuery0 方 法 的 第 3 个 和 第 4 个 参数 (CursorLoader 类 的 第 4 个 和 第 5 个 参数 ) 


可 以 用 来 指定 一 个 SQL 的 WHERE 子 句 来 对 查询 结果 进行 筛选 。 例如， 下 列 语句 内 检索 名 
FU Lee 结尾 的 人 : 


Cursor C; 
if (android.os.Build.VERSION.SDK INT «11) { 
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//---before Honeycomb--- 

C — managedQuery(allContacts, projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE '$Lee'", 

null, null); 
} else { 

//---Honeycomb and later--- 

CursorLoader cursorLoader = new CursorLoader ( 
this, 
allContacts, 
projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE '$Lee'", 
null 4, 
null); 

C — cursorLoader.loadInBackground(); 


} 


这 里 , managedQuery0 方 法 的 第 3 个 参数 (CursorLoader 构造 函数 的 第 4 个 参数 ) 包 含 了 
个 SQL 语句 ， 其 中 含有 要 搜索 的 名 字 (Lee)。 还 可 以 将 搜索 字符 串 放 在 方法 /构造 函数 的 
下 一 个 参数 中 ， 如 下 所 示 : 


Cursor c; 
if (android.os.Build.VERSION.SDK INT «11) 1 

//---before Honeycomb--- 

c = managedQuery(allContacts, projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] ("Lee"), null); 

} else | 

//---Honeycomb and later--- 
CursorLoader cursorLoader = new CursorLoader( 
this, 
allContacts, 
projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] {"sLee"}, 
null); 
c = cursorLoader.loadInBackground (); 


7.2.4 排序 


managedQuery0 方 法 的 最 后 一 个 参数 以 及 Cursorloader 类 的 构造 图 数 可 以 用 来 指定 
个 SQL 的 ORDER BY 子 句 来 对 得 询 结果 排序 。 例 如 ， 下 列 语句 将 联系 人 名 字 按 升序 进行 
排序 : 


Cursor c; 
if (android.os.Build.VERSION.SDK INT «11) { 

//---before Honeycomb--- 

c = managedQuery(allContacts, projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] ["$Lee"], 
ContactsContract.Contacts.DISPLAY NAME + " ASC"); 
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//---Honeycomb and later--- 


CursorLoader cursorLoader 


C 


— new CursorLoader( 
this, 

allContacts, 

projection, 
ContactsContract.Contacts.DISPLAY NAME + " 
new String[] ["$Lee"], 


ContactsContract.Contacts.DISPLAY NAME + " ASC"); 


LIKE 7", 


cursorLoader.loadInBackground(); 


创建 目 己 的 内 容 提供 者 


要 做 的 是 扩展 抽象 类 


本 节 将 学 习 如 何 创建 一 个 简单 的 内 容 提 供 者 来 存 
储 一 个 图 书 列表 。 为 了 便于 说 明 ， 内 容 提供 者 将 图 书 存 
储 在 一 个 包含 3 个 字段 的 数据 库 表 中 ， 如 图 7-3 所 示 。 
下 面 的 “ 试 一 试 ”展示 了 具体 的 操作 步骤 。 wep 


创建 自己 的 内 容 提供 者 


ContentProviders.zip CHX ff A] ELTE Wrox.com E FE 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 日 并 命名 为 ContentProviders. 
(2) 在 项 目的 src 文件 夹 下 增加 一 个 新 的 Java 类 文件 ， 并 命名 为 BooksProvider java. 
(3) 按 如 下 所 示 填 充 BooksProviderjava 文件 : 


package net.learn2develop.ContentProviders; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 
android. 


content.ContentProvider; 
content.ContentUris; 
content.ContentValues; 
content.Context; 
content.UriMatcher; 
database. 
database.SQLException; 
database.sqlite.SQLiteDatabase; 
database.sqlite.SQLiteOpenHelper; 
database.sqlite.SQLiteQueryBuilder; 
net.Uri; 

text.TextUtils; 

util.Log; 


Cursor; 
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public class BooksProvider extends ContentProvider { 
static final String PROVIDER NAME = 
"net.learn2develop.provider.Books"; 


static final Uri CONTENT URI - 
Uri.parse("content://"+ PROVIDER NAME + "/books") ; 


static final String ID = " id"; 
static final String TITLE = "title"; 
static final String ISBN = "isbn"; 


static final int BOOKS = 1; 
static final int BOOK ID = 2; 


private static final UriMatcher uriMatcher; 

static{ 
uriMatcher = new UriMatcher (UriMatcher.NO MATCH); 
uriMatcher.addURI (PROVIDER NAME, "books", BOOKS) ; 
uriMatcher.addURI (PROVIDER NAME, "books/#", BOOK ID); 


//---for database use--- 
SQLiteDatabase booksDB; 
static final String DATABASE NAME = "Books"; 
static final String DATABASE TABLE = "titles"; 
static final int DATABASE VERSION = 1; 
static final String DATABASE CREATE = 

"create table " + DATABASE TABLE + 

" ( id integer primary key autoincrement, " 

- "title text not null, isbn text not null);"; 


private static class DatabaseHelper extends SQLiteOpenHelper 
{ 
DatabaseHelper (Context context) { 
super (context, DATABASE NAME, null, DATABASE VERSION); 


@Override 
public void onCreate(SQLiteDatabase db) 
{ 

db .execSQL (DATABASE CREATE); 


@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, 
int newVersion) { 
Log.w("Content provider database", 
"Upgrading database from version " + 
oldVersion + " to " + newVersion 十 
", which will destroy all old data"); 
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db.execSQL ("DROP TABLE IF EXISTS titles"); 
onCreate (db) ; 


@Override 
public int delete(Uri arg0, String argl, String[] arg2) { 
// arg0 = uri 
// argi 
// arg2 = selectionArgs 
int count=0; 
switch (uriMatcher.match(arg0) ) { 
case BOOKS: 
count = booksDB. delete ( 
DATABASE TABLE, 


selection 


argl, 
arg2); 
break; 
case BOOK ID: 
String id = argO.getPathSegments ().get(1); 
count - booksDB.delete( 
DATABASE TABLE, 


AD 4 "os "opo 
(!'TextUtils.isEmpty(argl1) ? " AND (" + 
argi + ')' : "ey. 
arg2); 


break; 
default: throw new IllegalArgumentException ("Unknown URI " + argO0); 
} 
getContext().getContentResolver().notifyChange (arg0, null); 
return count; 


@Override 
public String getType(Uri uri) { 
switch (uriMatcher.match (ur1)) { 
//---get all books--- 
case BOOKS: 
return "vnd.android.cursor.dir/vnd.learn2develop.books "; 


//---get a particular book--- 
case BOOK ID: 


return "vnd.android.cursor.item/vnd.learn2develop.books "; 


default: 
throw new IllegalArgumentException ("Unsupported URI: "+ uri); 


) 


@Override 
public Uri insert(Uri uri, ContentValues values) { 


297 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


//---add a new book--- 
long rowID = booksDB. insert ( 
DATABASE TABLE, 


n mn 
F 


values); 


//---if added successfully--- 

1f (rowID>0) 

{ 
Uri uri = ContentUris.withAppendedId(CONTENT URI, rowID) ; 
getContext () .getContentResolver() .notifyChange( uri, null); 
returnuri;j; 

} 


throw new SQLException("Failed to insert row into " + uri); 


@Override 
public boolean onCreate() { 
Context context = getContext(); 
DatabaseHelper dbHelper = new DatabaseHelper (context) ; 
booksDB = dbHelper.getWritableDatabase(); 
return (booksDB == null)? false: true; 


@Override 
public Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 
SQLiteQueryBuilder sqlBuilder = new SQLiteQueryBuilder () ; 
sqlBuilder.setTables (DATABASE TABLE); 


if (uriMatcher.match(uri) == BOOK ID) 
//---if getting a particular book--- 
sqlBuilder .appendWhere ( 
ID + " = " + uri.getPathSegments () . get (1)) ; 


if (sortOrder==null || sortOrder=="") 
sortOrder = TITLE; 


Cursor c = sqlBuilder.query ( 
booksDB, 
projection, 
selection, 
selectionArgs, 
null , 
null, 
sortOrder) ; 


//---register to watch a content URI for changes--- 


c.setNotificationUri (getContext().getContentResolver(), uri); 
return c; 
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QOverride 
public int update(Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 
int count = 0; 
switch (uriMatcher.match (ur1) ) { 
case BOOKS: 
count = booksDB.update ( 
DATABASE TABLE, 
values, 
selection, 
selectionArgs) ; 
break; 
case BOOK ID: 
count = booksDB.update ( 
DATABASE TABLE, 
values, 
_ID + " = " + uri.getPathSegments().get(1) + 
(!TextUtils.isEmpty(selection) ? " AND (" + 
selection + ')' : ""), 
selectionArgs); 
break; 
default: throw new IllegalArgumentException ("Unknown URI " + uri); 
} 
getContext() .getContentResolver().notifyChange (uri, null); 
return count; 


(4) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net.learn2develop.ContentProviders" 
android:versionCode-"]" 
android:versionName-"1.0" > 


«uses-sdk android:minSdkVersion-"14" /> 
«application 


android:icon="@drawable/ic launcher" 
android:label-"8string/app name" > 


«activity 
android:label="@string/app name" 
android:name-".ContentProvidersActivity" > 


<intent-filter > 


«action android: name="android.intent.action.MAIN" /> 


«category android:name="android. intent.category. LAUNCHER" /> 
«/intent-filter» 
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«/activity» 
«provider android:name-"BooksProvider" 
android:authorities-"net.learn2develop.provider.Books'"» 
«/provider» 
</application> 


</manifest> 

示例 说 明 

在 本 例 中 ， 首 先 创建 一 个 名 为 BooksProvider 的 类 ， 它 扩展 了 ContentProvider 4%. 
这 个 类 中 重 写 的 各 个 方法 如 下 所 示 : 

e getType0 一 一 返回 给 定 URI 上 的 数据 的 MIME 类 型 

e onCreate() 一 一 当 启 动 提供 者 时 调用 

e query0 一 一 接收 客户 端 请 求 ， 结 果 以 Cursor 对 象形 式 返 回 


e. insert() 一 一 向 内 容 提供 者 中 插入 一 条 新 记录 
e. delete0 一 一 从 内 容 提供 者 中 删除 一 条 现 有 记录 
。 update0 一 一 在 内 容 提 供 者 中 更 新 一 条 现 有 记录 


在 内 容 提供 者 中 ， 可 以 目 由 选择 如 何 存储 数据 一 一 传统 的 文件 系统 、XML、 数 据 库 或 
者 通过 Web 服务 。 本 例 中 ， 使 用 前 一 章 讨 论 的 SQLite 数据 库 方法 。 
H E BooksProvider 类 中 定义 以 下 常量 : 


static final String PROVIDER NAME = 
"net.learn2develop.provider.Books"; 


Static final Uri CONTENT URI - 
Uri.parse ("content://"+ PROVIDER NAME + "/books"); 


static final String ID - " id"; 
static final String TITLE = "title"; 
static final String ISBN - "isbn"; 


static final int BOOKS - 1; 
static final int BOOK ID - 2; 


private static final UriMatcher uriMatcher; 

static 
uriMatcher = new UriMatcher (UriMatcher.NO MATCH); 
uriMatcher.addURI(PROVIDER NAME, "books", BOOKS); 
uriMatcher.addURI (PROVIDER NAME, “books/#", BOOK ID); 


//---tfor database use--- 

SOLiteDatabase booksDB; 

static final String DATABASE NAME = "Books"; 
static final String DATABASE TABLE = "titles"; 
static final int DATABASE VERSION - 1; 
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static final String DATABASE CREATE = 
"create table " + DATABASE TABLE + 
" ( id integer primary key autoincrement, 
+ "title text not null, isbn text not null);"; 


在 上 面 的 代码 中 可 看 到 ， 使 用 一 个 UriMatcher 对 象 来 解析 通过 一 个 ContentResolver 
传递 给 内 容 提 供 者 的 内 容 URI。 例如 ， 下 面 的 内 容 URI 代表 了 一 个 对 内 容 提供 者 中 的 所 有 
图 书 的 请 求 : 


content://net.learn2develop.provider.Books/books 
下 面 的 内 容 URI 代表 了 一 个 对 id 为 5 的 特定 图 书 的 请 求 : 
content://net.learn2develop.provider.Books/books/5 


内 容 提 供 者 使 用 SQLite 数据 库存 储 图 书 。 注 意 ， 使 用 SQLiteOpenHelper 辅助 类 来 协 
助 管理 数据 库 : 
private static class DatabaseHelper extends SQLiteOpenHelper 
{ 


DatabaseHelper (Context context) { 
super (context, DATABASE NAME, null, DATABASE VERSION) ; 


@Override 
public void onCreate (SQLiteDatabase db) 


1 
db.execSQL (DATABASE CREATE); 


@Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, 
int newVersion) { 
Log.w("Content provider database", 
"Upgrading database from version ™ + 
oldVersion + " to " + newVersion + 
", which will destroy all old data"); 
db.execSQL("DROP TABLE IF EXISTS titles"); 
onCreate (db) ; 


} 
接 下 来 ,通过 重 写 getType0 方 法 来 唯一 地 描述 内 容 提供 者 的 数据 类 型 。 使 用 UriMatcher 
对 象 ， 对 于 单 本 图 书 返 回 vnd.android.cursor.item/vnd.learn2develop.books， 对 于 多 本 图 书 返 
|a| vnd.android.cursor.dir/vnd.learn2develop.books: 
QOverride 
public String getType(Uri uri) 1 


switch (uriMatcher.match (uri) ) { 
/!4-—-get all books——— 
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case BOOKS: 


return "vnd.android.cursor.dir/vnd.learn2develop.books "; 


//---get a particular book--- 
Case BOOK ID: 


return "vnd.android.cursor.item/vnd.learn2develop.books "; 


default: 
throw new IllegalArgumentException("Unsupported URI: " + uri); 


} 


下 一 步 ， 重 写 onCreate0 方 法 以 在 内 容 提供 者 启动 时 打开 一 个 到 数据 库 的 连接 : 


@Override 

public boolean onCreate() { 
Context context = getContext (); 
DatabaseHelper dbHelper = new DatabaseHelper (context); 
booksDB = dbHelper.getWritableDatabase(); 


return (booksDB == null)? false:true; 
] 
EE queryO7j 1A, UfevrEZE P vm trig lp: 
QOverride 


public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 
SOLiteQueryBuilder sqlBuilder = new SQLiteQueryBuilder(); 
sqiBuilder.setTables(DATABASE TABLE); 


if (uriMatcher.match(uri) == BOOK ID) 
//---if getting a particular book--- 
sqiBuilder.appendWhere( 
ID + "-— ™ + uri.getPathSegments () . get (1)):; 


if (sortOrder--null || sortOrder--"") 
sortOrder = TITLE; 


Cursor c = sqlBuilder.query( 
booksDB, 
projection, 
selection, 
selectionArgs, 
null, 
null, 
sortOrder) ; 


//---register to watch a content URI for changes--- 


c.setNotificationUri (getContext ().getContentResolver(), uri); 
return c; 
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默认 情况 下 ， 查 询 的 结果 按 title 字段 进行 排序 。 查 询 结果 以 Cursor 对 象形 式 返回 。 
为 了 在 内 容 提 供 者 中 插入 一 本 新 图 书 ， 需 要 重 写 insert() 方 法 : 


QOverride 
public Uri insert(Uri uri, ContentValues values) | 
//---add a new book--- 
long rowID = booksDB.insert( 
DATABASE TABLE, 


values); 


//---if added successfully--- 
if (rowID>0) 


{ 
Uri uri = ContentUris.withAppendedId (CONTENT URI, rowID); 
getContext().getContentResolver().notifyChange( uri, null); 
return uri; 

} 


throw new SQLException ("Failed to insert row into ™ + uri); 


} 


- 旦 记录 被 成 功 插入 ， 则 调用 ContentResolver 的 notifyChange0 方 法 。 这 将 通知 已 注 
册 的 观察 者 更 新 了 一 行 。 
者 要 删除 一 本 图 书 ， 则 重 写 delete0 方 法 如 下 : 


@Override 

public int delete(Uri arg), String argl, String[] arg2) { 
// arg0 = uri 
// argl 
// arg2 = selectionArgs 


selection 


int count-0; 
switch (uriMatcher.match (argQ0) ) { 
case BOOKS: 
count = booksDB.delete ( 
DATABASE TABLE, 
argl, 
arg2); 
break; 
case BOOK ID: 
String id = argÜ0.getPathSegments().getí(1); 
count - booksDB.delete( 
DATABASE TABLE, 
ID+ "=" 4 id + 
(!TextUtils.isEmpty(argl) 2 " AND (" + 
argi + T)" gk "x. 
arg2); 
break; 
default: throw new IllegalArgumentException ("Unknown URI "+ argQ); 
} 
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getContext ().getContentResolver().notifyChange(argO0, null); 
return count; 


} 


同样 ， 在 删除 操作 后 要 调用 ContentResolver 的 notifyChange0 方 法 。 这 将 通知 已 注册 
的 观察 者 删除 了 一 行 。 | 


@Override 
public int update(Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 
int count = 0; 
switch (uriMatcher.match(uri))! 
case BOOKS: 
count = booksDB.update ( 
DATABASE TABLE, 
values, 
selection, 
selectionArgs) ; 
break; 
case BOOK ID: 
count = booksDB. update ( 
DATABASE TABLE, 
values, 
ID + " = ™ + uri.getPathSegments().get(1) + 
('TextUtils.isEmpty(selection) ? " AND (" + 
selection + ')' : ™"), 
selectionArgs); 
break; 
default: throw new IllegalArgumentException ("Unknown URI ”+ uri); 
} 
getContext () .getContentResolver() .notifyChange (uri, null); 
return count; 


} 
与 insert() 和 delete0 方 法 一 样 ， 在 更 新 后 调用 ContentResolver 的 notifyChange() 77. 
这 将 通知 已 注册 的 观察 者 更 新 了 一 行 。 
最 后 ， 为 了 将 内 容 提供 者 注册 到 Android， 可 以 修改 AndroidManifest xml 文件 ， 添 加 


«provider» JC 25 


74 使 用 内 容 提 供 者 
既然 已 经 构建 了 目 己 的 新 的 内 容 提 供 者 ， 那 就 可 以 在 Android 应 用 程序 中 测试 它 。 下 
面 的 “ 试 一 试 ” 展 示 了 是 如 何 做 到 这 一 点 的 。 


使 用 新 建 的 内 容 提 供 者 
a) 使 用 在 前 一 节 中 所 创建 的 同一 个 项 目 ， 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 
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<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"ISBN" /> 
«EditText 
android: id="@+id/txtISBN" 
android: layout height-"wrap content" 
android: layout width-"fill parent" /? 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="Title" /> 
«EditText 
android: id="@+id/txtTitle" 
android: layout height-"wrap content" 
android: layout width-"fill parent" /> 
<Button 
android: text="Add title" 
android: id="@+id/btnAdd" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: onClick="onClickAddTitle" /> 
<Button 
android: text="Retrieve titles" 
android: id="@+id/btnRetrieve" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: onClick="onClickRetrieveTitles" /> 
</LinearLayout> 


(2) 在 ContentProvidersActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.ContentProviders; 


import android.app.Activity; 


import android.content.ContentValues; 


import android.content.CursorLoader; 


import android.database.Cursor; 


import android.net.Uri; 
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import android.os.Bundle; 
import android.view.View; 
import android.widget.EditText; 
import android.widget.Toast; 


public class ContentProvidersActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


public void onClickAddTitle (View view) { 

//---add a book--- 

ContentValues values = new ContentValues(); 

values .Put (BooksProvider.TITLE, ((EditText) 
findViewById(R.id.txtTitle)).getText().toString()); 

values.put(BooksProvider.ISBN, ((EditText) 
findViewById(R.id.txtISBN)).getText().toString()); 

Uri uri — getContentResolver().insert( 
BooksProvider.CONTENT URI, values); 

Toast.makeText(getBaseContext(),uri.toString(), 
Toast.LENGTH LONG).show(); 


public void onClickRetrieveTitles (View view) { 
//---retrieve the titles--- 
Uri allTitles = Uri.parse ( 
"content: //net.learn2develop. provider .Books/books") ; 
Cursor c; 
if (android.os.Build.VERSION.SDK INT <11) { 
//---before Honeycomb--- 
c = managedQuery(allTitles, null, null, null, 
"title desc"); 
} else { 
//---Honeycomb and later--- 
CursorLoader cursorLoader = new CursorLoader( 
this, 
allTitles, null, null, null, 
"title desc"); 
c = cursorLoader.loadInBackground(); 
] 
if (c.moveToFirst()) { 
do { 
Toast.makeText (this, 
c.getString(c.getColumnIndex( 
BooksProvider. ID)) +", " + 
c.getString(c.getColumnIndex ( 
BooksProvider.TITLE)) +", " + 
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c.getString(c.getColumnIndex ( 
BooksProvider.ISBN)), 
Toast.LENGTH SHORT).show(); 
} while (c.moveToNext()); 


} CESPE 
} 
" ContentProviders 
} ISBN 
EN | Mp - » 978-1118199541 
(4) 输入 -本 图 书 的 ISBN 和 书 名 并 单 击 Add title sen ine pero ear 
按钮 。 图 7-4 展示 了 由 Toast 类 显示 添加 到 内 容 提供 者 M Add ttle 


的 图 书 的 URI。 为 了 检索 存储 在 内 容 提 供 者 中 的 所 有 书 
4, Hh Retrieve titles 按钮 并 观察 使 用 Toast 类 显示 的 值 。 


Retrieve titles 


示例 说 明 
首 I , 修 改 活 动 , XX FE H] F : i AY 以 输入 本 图 书 的 content://net.learnzdevelop. provider. 
Books/books/1 


ISBN 和 书 名 来 添加 到 刚刚 创建 的 内 容 提 供 者 中 。 
要 添加 一 本 图 书 到 内 容 提 供 者 中 ， 可 以 创建 一 个 新 
的 ContentValues WR, 然后 用 与 此 图 书 有 关 的 各 种 信息 
//---add a book--- 
ContentValues values - new ContentValues(); 
values.put(BooksProvider.TITLE, ((EditText) 
findViewById(R.id.txtTitle)).getText ().toString()): 
values.put(BooksProvider.ISBN, ((EditText) 
findViewById(R.id.txtISBN)).getText().toString()); 
Uri uri - getContentResolver().insert( 
BooksProvider.CONTENT URI, values); 


注意 ， 因 为 内 容 提 供 者 是 在 同一 个 包 中 ， 所 以 可 以 分 别 使 用 BooksProvider TITLE 和 
BooksProvider.ISBN 常量 来 表示 title 和 isbn 字段 。 如 果 是 从 另 一 个 包 来 访问 内 容 提 供 者 的 ， 
那么 将 不 能 够 使 用 这 些 和 常量 。 在 那 种 情况 下 ， 需 要 直接 指定 字段 名 称 ， 如 下 所 示 : 


ContentValues values = new ContentValues(); 
values.put("title", ((EditText) 
findViewById(R.id.txtTitle)).getText ().toString()); 
values.put("isbn", ((EditText) 
findViewById (R.id.UtxtISBN)).getText ().toString()); 
Uri uri = getContentResolver().insert( 
Uri.parse( 
"content://net.learn2develop.provider.Books/books"), 
values); 


妨 外 还 要 注意 ， 对 于 外 部 包 ， 需 要 使 用 完全 限定 的 名 称 来 引用 内 容 URI: 
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Uri.parse ( 


"content://net.learn2develop.provider.Books/books"), 


要 检索 内 容 提 供 者 中 的 所 有 书 名 ， 可 使 用 下 面 的 代码 片段 : 


//---retrieve the titles--- 
Uri allTitles = Uri.parse( 
"content://net.learn2develop.provider.Books/books"); 
Cursor c; 
if (android.os.Build.VERSION.SDK INT «11) { 
//---before Honeycomb--- 
c = managedQuery(allTitles, null, null, null, 
"title desc"); 
} else | 
//---Honeycomb and later--- 
CursorLoader cursorLoader - new CursorLoader( 
this, 
allTitles, null, null, null, 
"title desc"); 
c = cursorLoader.loadInBackground(); 
} 
if (c.moveToFirst()) { 
do { 
Toast.makeText (this, 
c.getString (c.getColumnindex ( 
BooksProvider. ID)) + ", ™ + 
C.getString(c.getColumnIndex( 
BooksProvider.TITLE)) + ", F + 
C.getString(c.getColumnIndex ( 
BooksProvider.ISBN)), 
Toast.LENGTH SHORT) .Show () 7 
} while (c.moveToNext ()); 


} 


前 面 的 查询 将 返回 按 title 字段 降序 排列 的 结果 。 
如 果 想 更 狐 一 本 图 书 的 详细 信息 , 调用 update0 方 法 , 使 用 内 容 URI 来 指示 图 书 的 ID, 


ContentValues editedValues = new ContentValues(); 
editedValues.put(BooksProvider.TITLE, "Android Tips and Tricks"); 
getContentResolver () .update ( 
Uri. parse ( 
"content: //net.learn2develop.provider.Books/books/2"), 
editedValues, 
null, 
nulli: 


要 删除 一 本 图 书 ， 调 用 delete0 方 法 ， 使 用 内 容 URI 来 指示 图 书 的 ID: 


//---delete a title--- 
getContentResolver().delete( 


Uri.parse("content://net.learn2develop.provider. 


第 7 章 ， 内容 提 供 者 


Books/books/2"), 
null, null); 


要 删除 所 有 图 书 ， 只 要 在 内 容 URI 中 省 略图 书 的 ID: 
//---delete all titles--- 
getContentResolver () .delete { 
Uri.parse("content://net.learn2develop.provider. 
Books/books"), 
null, null); 


7.5 kx 


在 这 一 章 中 ， 我 们 了 解 了 什么 是 内 容 提供 者 ， 以 及 如 何 使 用 一 些 内 置 在 Android 中 的 
内 容 提供 者 。 特 别 是 ， 我 们 学 习 了 如 何 使 用 Contacts 内 容 提供 者 。Google 做 出 的 提供 内 容 
提供 者 的 决定 使 得 应 用 程序 可 以 通过 一 套 标 准 的 编程 接口 进行 数据 共享 。 除了 内 置 的 内 容 
提供 者 以 外 ， 还 可 以 由 目 己 创建 目 定 义 的 内 容 提 供 者 来 与 其 他 包 实 现 数据 共 至 。 


1. 写 一 个 查询 ， 实 现 从 Contacts 应 用 程序 中 检索 所 有 包含 单词 jack 的 联系 人 。 
2. 说 出 在 实现 自己 的 内 容 提供 者 时 必须 重 写 的 方法 。 

3. 如 何在 AndroidManifest.xml 文件 中 注册 一 个 内 容 提 供 者 ? 
练习 答案 参见 附录 C. 


本 章 主 要 内 容 
主 是 关键 概念 
检索 一 个 托管 游标 使 用 managedQuery0 方 法 (对 于 早 于 Honeycomb 的 设备 ) 或 使 


用 CursorLoader 类 (对 于 Honeycomb 或 之 后 的 设备 ) 
为 内 容 提供 者 指定 得 询 的 两 种 方法 | 使 用 查询 URI Sd POE MASA EA E 
在 一 个 内 容 提 供 者 中 检索 一 列 的 值 | 使 用 getColumnIndex0 方 法 
访问 联系 人 姓名 所 用 的 查询 URI ContactsContract.Contacts.CONTENT URI 
访问 联系 人 电话 号 码 所 用 的 查询 i 
— ContactsContract. CommonDataKinds.Phone. CONTENT URI 


创建 目 己 的 内 容 提供 者 创建 一 个 扩展 ContentProvider 类 的 类 


本 章 将 介绍 以 下 内 容 : 

e 如 何以 编程 方式 通过 应 用 程序 发 送 SMS A 

e 如 何 使 用 内 置 的 Messaging 应 用 程序 发 送 SMS JH El 
e 如 何 接收 传 入 的 SMS 消 县 

e 如 何 通过 应 用 程序 发 送 电子 邮件 消 县 


旦 启动 并 运行 基本 的 Android 应 用 程序 ， 下 一 个 有 趣 的 事情 台 是 为 其 添加 与 外 界 通 
信 的 能 力 。 您 可 能 希望 在 一 件 事情 发 生 (如 您 到 达 了 一 个 特定 的 地 理 位 置 ) 时 应 用 程序 可 以 
给 男 一 部 手机 发 送 SMS 消息 ， 或 者 可 能 希望 访问 一 个 提供 特定 服务 (如 汇率 、 天 气 等 ) 的 
Web 服务 。 
在 本 章 中 , 将 学 习 如 何以 编程 方式 从 Android 应 用 程序 中 发 送 和 接收 SMS 消息 。 还 将 
学 习 如 何在 Android 应 用 程序 中 调用 Mail 应 用 程序 来 向 其 他 用 户 发 送 电子 邮件 。 


81 SMS 消息 传递 


SMS 消息 传递 是 当今 手机 上 的 一 个 主要 的 杀手 级 应 用 一 一 对 于 一 些 用 户 来 说 , 这 跟 手 
机 本 喘 一 样 必 不 可 少 。 当前 您 购买 的 任何 手机 都 至 少 应 该 具有 SMS 消息 传递 的 功能 ,几乎 
所 有 年 龄 段 的 用 户 都 知道 如 何 发 送 和 接收 这 类 消息 。Android 珊 有 一 个 内 置 的 SMS 应 用 程 
序 ， 可 以 接收 和 发 送 SMS 消息 。 不 过 ， 在 某 些 情况 下 ， 您 可 能 想 要 将 SMS 功能 集成 到 您 
自己 的 应 用 程序 中 。 举 个 例子 , 您 也 许 打 算 写 一 个 能 够 按 固定 时 间 间 隔 自 动 发 送 SMS 消息 
的 应 用 程序 。 例 如 ， 您 想 追 踪 孩 子 的 位 置 时 这 就 非常 有 用 一 一 只 要 给 他 们 一 个 Android 设 
备 ， 可 以 每 30 分 钟 发 出 一 条 包含 地 理 位 置信 息 的 SMS 消息 就 行 了 。 这 下 ， 您 就 对 他 们 放 
了 学 是 否 真 的 去 了 图 书馆 了 解 得 一 清二 楚 ( 当 然 ， 这 也 意味 着 您 不 得 不 为 发 送 这 类 短信 而 

本 节 介 绍 如 何在 Android 应 用 程序 中 以 编程 方式 发 送 和 接收 SMS 消息 。 对 Android FF 
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发 人 员 来 说 ， 好 消息 是 不 需要 用 一 个 真正 的 设备 来 对 SMS 消息 传递 进行 测试 : 免费 的 
Android 模拟 器 提供 了 这 一 功能 。 

8.1.1 以 编程 方式 发 送 SMS 消息 


首先 ， 您 将 学 习 如 何以 编程 方式 通过 应 用 程序 发 送 SMS 消息 。 使 用 这 种 方法 ， 应 用 
程序 可 以 日 动 发 送 SMS 消 朋 给 收 件 人 ， 而 无 须 用 户 干预 。 下 和 面 的 “ 试 一 试 ”将 告诉 您 这 是 
如 何 做 到 的 。 


SMS.zip (C79 X PERI LAE Wrox.com E FR 


(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 命 名 为 SMS. 
(2) 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 来 替换 TextView: 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btnSendSMS" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="Send SMS" 
android:onClick="onClick" /> 


</LinearLayout> 
(3) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.SMS" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
«uses-permission android:name-"android.permission.SEND SMS"/> 


«application 
android:icon="@drawable/ic launcher" 
android:label="@string/app name" > 
<activity 

android:label="@string/app name" 
android:name=".SMSActivity" > 
<intent-filter > 
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«action android:name="android.intent.action.MAIN™ /> 


«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 
«/activity» 
</application> 


</manifest> 


(4) 在 SMSActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.SMS; 


import android.app.Activity; 
import android.os.Bundle; 


import android.telephony.SmsManager ; 
import android.view.View; 


public class SMSActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView (R.layout.main) ; 


public void onClick(View v) { 
sendSMS ("5556", "Hello my friends!"); 


} 
//---sends an SMS message to another device--- 
private void sendSMS (String phoneNumber, String message) 
{ 
SmsManager sms = SmsManager.getDefault(); 
sms.sendTextMessage(phoneNumber, null, message, null, null); 
} 


} 
(5) FX F11 Æ Android 模拟 器 上 调试 应 用 程序 。 使 用 Android SDK 和 AVD Manager 
局 动 另 一 个 AVD。 
(6) 在 第 1 个 Android 模拟 器 (5544) 上 ， 单 击 Send SMS 按钮 来 发 送 SMS 消息 到 第 2 
个 模拟 器 (5556)。 图 8-1 展示 了 由 第 2 个 模拟 器 收 到 的 SMS 消 县 (注意 在 第 2 个 模拟 器 顶 
端的 通知 栏 )。 


示例 说 明 


文件 中 指定 。 这 可 以 确保 在 应 用 程序 安装 时 ， 用 户 确 切 地 知道 它 需要 哪些 访问 权限 。 
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F 
日 ”5 下 Android AL 


EB 15555215554: Hello my friends! 


OL Google - 
pom. UPPER i 


图 8-1 


由 于 发 送 SMS HRA SBOP SC Uh Be, KEE AndroidManifest.xml 文件 中 
指明 SMS 权限 可 以 使 用 户 决定 是 否 允 许 安 装 应 用 程序 。 

使 用 SmsManager 类 ， 可 以 以 编程 方式 来 发 送 SMS 消息 。 与 其 他 类 不 同 ， 不 能 直接 实 
例 化 这 个 类 ， 而 是 要 调用 getDefault0 静 态 方 法 获得 一 个 SmsManager 对 象 。 然 后 ， 使 用 
sendTextMessage0 方 法 来 发 送 SMS HH: 

//---sends an SMS message to another device--- 


private void sendSMS (String phoneNumber, String message) 
{ 


SmsManager sms = SmsManager.getDefault (); 
sms .sendTextMessage (phoneNumber, null, message, null, null); 


} 
以 下 是 sendTextMessage0) 方 法 用 到 的 5 个 参数 : 
e destinationAddress- WC FE ALES] FE 5 3 


e scAddress 服务 中 心地 址 ，null 代表 默认 的 SMSC 
e text —— SMS JH BMA 


发 送 消 息 后 调用 的 挂 起 的 意图 (下 一 节 将 详细 讨论 ) 
消息 递送 后 调用 的 挂 起 的 意图 (下 一 区 详细 讨论 ) 


e sentintent 


e deliveryIntent 


O 注意 : 如 果 使 用 SmsManager 类 以 编程 方式 发 送 SMS 消息 ， 发 送 的 消息 不 会 
出 现在 发 送 者 的 内 置 的 Messaging 应 用 程序 中 。 
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8.1.2 发送 消息 后 获取 反馈 


前 一 节 学 习 了 如 何 使 用 SmsManager 类 以 编程 方式 发 送 SMS JAS, (Bey TB TES e CS 
被 正确 发 送 了 了 呢 ? 要 达到 此 目的 ， 可 以 创建 两 个 PendingIntent 对 象 来 监视 SMS WAGE 
过 程 中 的 状态 。 这 两 个 PendingIntent 对 象 传递 给 sendTextMessage0 方 法 的 最 后 两 个 参数 。 
下 面 的 代码 片段 展示 了 如 何 监视 被 发 送 的 SMS 消 县 的 状态 : 


package net.learn2develop.SMS; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.app.PendingIntent; 
android.content.BroadcastReceiver; 
android.content.Context; 
android.content.Intent; 
android.content.IntentFilter; 
android.os.Bundle; 


android.telephony.SmsManager; 
android.view.View; 


android.widget.Toast; 


class SMSActivity extends Activity { 


String SENT = "SMS SENT"; 

String DELIVERED = "SMS DELIVERED"; 

PendingIntent sentPI, deliveredPI; 

BroadcastReceiver smsSentReceiver, smsDeliveredReceiver; 


/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedInstanceState) ; 
setContentView(R.layout.main); 


sentPI = PendingIntent.getBroadcast(this, 0, 
new Intent(SENT), 0); 


deliveredPI = PendingIntent.getBroadcast(this, 0, 
new Intent(DELIVERED), 0); 


@Override 
public void onResume() { 


super .onResume () ; 


//---create the BroadcastReceiver when the SMS is sent--- 
smsSentReceiver = new BroadcastReceiver () { 
@Override 
public void onReceive (Context arg0, Intent argl) I 
switch (getResultCode () ) 
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{ 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS sent", 
Toast.LENGTH SHORT) .show() ; 
break; 
case SmsManager.RESULT ERROR GENERIC FAILURE: 
Toast.makeText (getBaseContext(), "Generic failure", 
Toast.LENGTH SHORT) .show() ; 
break; 
case SmsManager.RESULT ERROR NO SERVICE: 
Toast.makeText (getBaseContext(), "No service", 
Toast.LENGTH SHORT) .show() ; 
break; 
case SmsManager.RESULT ERROR NULL PDU: 
Toast.makeText(getBaseContext(), "Null PDU", 
Toast.LENGTH SHORT) .show() ; 
break; 
case SmsManager.RESULT ERROR RADIO OFF: 
Toast.makeText (getBaseContext(), "Radio off", 
Toast.LENGTH SHORT) .show() ; 
break ; 


//---create the BroadcastReceiver when the SMS is delivered--- 
smsDeliveredReceiver = new BroadcastReceiver () { 
@Override 
public void onReceive (Context arg0, Intent argl) { 
switch (getResultCode () ) 
{ 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS delivered", 
Toast.LENGTH SHORT) .Show () ; 
break ; 
case Activity.RESULT CANCELED: 
Toast.makeText (getBaseContext(), "SMS not delivered", 
Toast.LENGTH SHORT) .show() ; 
break ; 


//---register the two BroadcastReceivers--- 
registerReceiver(smsDeliveredReceiver, new IntentFilter (DELIVERED) ) ; 
registerReceiver(smsSentReceiver, new IntentFilter(SENT)); 


GOverride 
public void onPause() { 
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super .onPause() ; 

//---unregister the two BroadcastReceivers--- 
unregisterReceiver(smsSentReceiver); 
unregisterReceiver (smsDeliveredReceiver) ; 


public void onClick(View v) { 
sendSMs ("5556", "Hello my friends!"); 


} 
//---sends an SMS message to another device--- 
private void sendSMS(String phoneNumber, String message) 
{ 
SmsManager sms = SmsManager.getDefault(); 
sms .sendTextMessage (phoneNumber, null, message, sentPI, deliveredPI) ; 
} 


} 
上 述 示例 在 onCreate0 方 法 中 创建 了 两 个 PendingIntent 对 象 : 
sentPI = PendingIntent.getBroadcast(this, 0, 


new Intent(SENT), 0); 


deliveredPI = PendingIntent.getBroadcast(this, 0, 
new Intent(DELIVERED), 0); 


这 两 个 PendingIntent 对 象 用 于 后 面 在 SMS 消息 被 发 送 (SMS SENT) 和 递送 (SMS_ 
DELIVERED) 后 发 送 广播 。 

然后 ， 在 onResume0 方 法 中 创建 并 注册 了 两 个 BroadcastReceiver。 这 两 个 Broadcast- 
Receiver 侦 听 与 SMS SENT fll SMS DELIVERED 匹配 的 意图 (分 别 在 发 送 和 递送 消息 后 由 
SmsManager 触发 ): 


//---register the two BroadcastReceivers--- 
registerReceiver (smsDeliveredReceiver, new IntentFilter (DELIVERED) ); 
registerReceiver(smsSentReceiver, new IntentFilter (SENT) ); 


在 每 一 个 BroadcastReceiver 中 ， 重 写 onReceive0 方 法 并 得 到 当前 的 结果 码 。 
两 个 PendingIntent 对 象 被 传递 给 sendTextMessage0 方 法 的 最 后 两 个 参数 : 


SmsManager sms = SmsManager.getDefault(í(); 
sms .sendTextMessage (phoneNumber, null, message, sentPI, deliveredPI); 


在 这 种 情况 下 ， 无 论 消 息 是 被 正确 发 送 还 是 递送 失败 ， 都 将 通过 这 两 个 PendingIntent 
对 象 来 通知 其 状态 。 
最 后 ， 在 onPause0 方 法 中 ， 注 销 这 两 个 BroadcastReceiver 对 象 。 
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注意 : 如 果 在 Android 模拟 器 上 测试 应 用 程序 ， 只 有 sentPI PendingIntent 对 象 
| 会 被 触发 , deliveredPI PendingIntent 对 象 却 不 会 . 在 实际 设备 上 , 两 个 Pending- 
Intent 对 他 都 会 触发 。 


8.1.3 ”使 用 意图 发 送 SMS 消息 


使 用 SmsManager 类 ， 可 以 通过 应 用 程序 发 送 SMS IB. ms m$» JI 
Messaging 应 用 程序 。 但 有 时 候 ， 如 果 可 以 直接 调用 内 置 的 Messaging 应 用 程序 并 让 和 它 做 发 
送 消息 的 所 有 工作 ， 发 送 SMS 消息 会 变 得 更 容易 些 。 

要 在 应 用 程序 中 激活 内 置 的 Messaging 应 用 程序 ， 可 以 使 用 一 个 Intent 对 象 和 MIME 
类 型 vnd.android-dirmms-sms， 如 下 面 的 代码 片段 所 示 : 

Intent 1 = new 


Intent (android.content.Intent.ACTION VIEW) ; 
1.putExtra("address", "5556; 5558; 5560"); 


i.putExtra("sms body", "Hello my friends!") ; 
i.setType ("vnd.android-dir/mms-sms") ; 
startActivity (1) ; 
这 将 调用 Messaging 应 用 程序 ， 如 图 8-2 所 示 。 注 意 ， 可 以 发 送 SMS 给 多 个 收 件 人 ， 
只 再 要 用 (在 putExtra0 方 法 中 ) 分 号 分 隅 每 个 电话 号 但 就 行 了 。 这 些 号 码 在 Messaging 应 用 
FE ERR S A JT. 


F 
W^ 5554: ndroud A 


| 9960, 5558, 5556 


4 d 3 people 


5560, 5558, 5556, 


Hello my friends! 


图 8-2 
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注意 : 如 果 使 用 这 个 方法 调用 Messaging 应 用 程序 ， 就 没有 必要 在 Android- 
| Manifest xml 文件 中 指定 SEND SMS 权限 ， 因 为 您 的 应 用 程序 并 非 是 最 终 发 
送 消息 的 那个 。 


8.1.4 接收 SMS 消息 


除了 从 Android 应 用 程序 发 送 SMS 消息 外 ， 还 可 以 在 应 用 程序 中 使 用 Broadcast- 
Receiver 对 象 接收 传 入 的 SMS 消 县 。 如 果 和 希望 应 用 程序 在 收 到 一 条 特定 的 SMS 消息 时 执 
行 一 个 动作 ， 这 就 很 有 用 了 。 例 如 ， 您 可 能 想 追 踪 您 的 手机 位 置 以 防 丢 失 或 被 盗 。 在 这 种 
情况 下 ， 可 以 编写 一 个 应 用 程序 ,用 来 自动 侦 听 包含 一 些 秘密 代码 的 SMS S. 一 旦 收 到 
此 类 信息 ， 就 可 以 给 发 送 者 发 回 一 条 包含 位 置 坐标 的 SMS IHR. 

下 面 的 “ 试 一 试 ” 展 示 了 如 何以 编程 方式 侦 听 传 入 的 SMS 消息 。 
接收 SMS 消息 

(1) 使 用 在 前 一 节 所 创建 的 同一 个 项 目 ， 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 
显示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.SMS" 
android: versionCode="1" 
android: versionName="1.0" > 


«uses-sdk android:minSdkVersion-"10" /> 
«uses-permission android:name-"android.permission.SEND SMS"/> 
«uses-permission android:name-"android.permission.RECEIVE SMS"/» 


«application 
android:icon-"G8drawable/ic launcher" 
android:label-"8string/app name" > 
«activity 
android: label="@string/app name" 
android:name-".SMSActivity" > 
<intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«receiver android:name-".SMSReceiver'"» 
<intent-filter> 
<action android:name= 
"android.provider.Telephony.SMS RECEIVED" /> 
</intent-filter> 
</receiver> 
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«/application» 


</manifest> 


(2) 在 项 目的 sre 文件 夹 中 , 在 包 名 下 增加 一 个 新 的 类 文件 , 并 命名 为 SMSReceiver (如 
图 8-3 所 示 )。 


Mew Java Class 


Java Class 
Create a new Java class. 


Source folder: SMS/'sre Browse... | 
Package: net.learn2develop.SMS | Browse.. | 


| | Enclosing type: Browse... 


Mame: SMSRecerver 


Modifiers: (8, public (5 default private protected 
| abstract | |final static 


Superclass: java.lang.Object Browse... | 


Interf aces: | Add... 


Remove 


Which methed stubs would you like to create? 
[| public static void main(String[] args) 
[E Constructors from superclass 
[4 Inherited abstract methods 
Do you want te add comments? (Configure templates and default value here) 


| Generate comments 


图 8-3 


(3) 按 如 下 所 示 编 写 SMSReceiverjava 文件 : 


package net.learn2develop.SMS; 


import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.os.Bundle; 

import android.telephony.SmsMessage; 
import android.util.Log; 

import android.widget.Toast; 


public class SMSReceiver extends BroadcastReceiver 
{ 
@Override 
public void onReceive (Context context, Intent intent) 
{ 
//---get the SMS message passed in--- 
Bundle bundle = intent.getExtras(); 
SmsMessage[] msgs = null; 
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String str = "SMS from "; 
if (bundle != null) 
{ 
//---retrieve the SMS message received--- 
Object[] pdus = (Object[]) bundle.get("pdus"); 
msgs = new SmsMessage[pdus.length]; 
for (int i-0; i«msgs.length; i++) { 
msgs[i] = SmsMessage.createFromPdu ((byte[])pdus[i]); 
if (i==0) { 
//---get the sender address/phone number--- 
str += msgs[i].getOriginatingAddress (); 
Str += ": "rz 
} 
//---get the message body--- 
str += msgs[i].getMessageBody().toString(); 
} 
//---display the new SMS message--- 
Toast.makeText (context, str, Toast.LENGTH SHORT) .show() ; 
Log.d("SMSReceiver", str); 


(4) TZ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 
(5) 使 用 DDMS， 给 模拟 器 发 送 一 条 消息 。 应 用 程序 将 能 够 接收 到 这 条 消息 并 用 Toast 
类 进行 显示 (如 图 8-4 所 示 )。 


E 25 4Android_4.0 三 EX 


B 17:5] 
SMS A DOMS - SMS/'src/net/leam2develop/S MS S MS Receiver java - Eclips 
File Edit Refactor Source Rum — Mawigate Search Project Window 
Send SMS a ETE | 
| mz Gai #r7r 
k s a w Cw FL i= = * 
- Bl Devices 2 EI] Thread 
Send SMS using Intent Bu = — => 
+ w g 山 3m s T &u 
Marne tal 
[S] =mulatcr5554 Online | 
SySTeMm_process 96 
cpm.android.systernui 148 
corm.android.inputmethod.latin — 163 
cpm.andraid.phone 175 
rau amelie cobtiriec 7g E 
rm | F 
{Emulator Conia 号 口 
Telenharry Status 
Voice [nome =| Speed: ‘Full a 
Data: [hame -| Latency: Mane — J 
Telephony Actions 
Incoming number: 5556 
SMS from 5556: This is a long SMS ^ Veice 
message that is longer than 160 LE 
characters. As you can see, | have nothing Message: This is a long SMS message + 
T" P AFA " : : that is longer than 160 
much to say here except to type in as PEIRESE sre 


many useless words as possible so that | have nothing much to say 


can exceed the 160 characters limit. OK, 
looks like | have exceeded the limit. :-) 


EB Logtat| E Console Ts 


LI 


图 8-4 


321 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


示例 说 明 

要 侦 听 传 入 的 SMS 消息 ， 需 要 创建 一 个 BroadcastReceiver 类 。BroadcastReceiver 类 使 
应 用 程序 接收 其 他 应 用 程序 使 用 sendBroadcastO 方 法 发 送 的 意图 。 从 本 质 上 讲 ， 它 使 您 的 
应 用 程序 可 以 处 理由 其 他 程序 应 用 所 引发 的 事件 。 当 接收 到 一 个 意图 对 象 时 ， 调 用 
onReceive() 方 法 。 因 此 ， 需 要 重 写 这 一 方法 。 

onReceive() 方 法 在 收 到 一 个 传 入 的 SMS YH IN eth A. SMS 消 明 通过 一 个 Bundle 对 
象 包含 在 Intent 对 象 ( 即 intent; onReceive0 方 法 的 第 二 个 参数 ) 中 。 注 意 收 到 的 每 条 SMS 
消息 都 会 调用 onReceive0 方 法 。 如 果 设 备 收 到 J 了 5 条 SMS 消息 ，onReceive0 方 法 就 会 被 
调用 5 iX. 

每 条 SMS 消息 以 PDU 格式 存储 在 一 个 Object 数组 中 。 如 果 SMS 消息 少 于 160 个 字 
符 ， 那 么 数组 中 只 包含 一 个 元 素 。 否 则 ， 该 消 明 将 被 分 割 成 多 条 更 小 的 消 上 号 ， 作 为 数组 中 
的 多 个 元 素 存 储 。 

要 提取 每 条 消 县 的 内 容 ， 可 以 使 用 SmsMessage 类 的 静态 方法 createFromPdu0。 发 件 
人 的 电话 号 码 通过 getOriginatingAddress() 方 法 来 获得 ， 因 此 如 果 需 要 给 发 送 者 发 一 个 自动 
回复 ， 束 可 以 使 用 该 方法 获得 发 送 者 的 电话 号 码 。 要 提取 消息 的 正文 ， 需 要 使 用 
getMessageBody()7; iJ; . 

BroadcastReceiver 有 一 个 有 趣 的 特性 : 即使 应 用 程序 不 在 运行 ， 您 也 可 以 继续 侦 听 传 
入 的 SMS 消息 ， 只 要 应 用 程序 已 经 安装 在 设备 上 ， 任 何 传 入 的 SMS 消 奶 都 将 被 该 应 用 程 
序 所 接收 。 


1. 阻止 Messaging 应 用 程序 接收 消息 


在 前 一 节 您 可 能 注意 到 了 ， 每 次 回 模拟 堪 人 (或 设备 ) 友 送 SMS 消 县 时， 您 的 应 用 程序 和 
A EH Messaging 应 用 程序 都 会 接收 它 。 这 是 因为 在 收 到 SMS HAIN, Android 设备 上 的 
所 有 应 用 程序 (包括 Messaging 应 用 程序 ) 会 轮流 处 理 传 入 的 消息 。 但 是 ， 有 时候 不 希望 看 
到 这 种 行为 一 一 例如 ， 您 可 能 希望 目 己 的 应 用 程序 收 到 消息 ， 然 后 阻止 将 消息 发 送 到 其 他 
应 用 程序 。 这 种 功能 十 分 有 用 ， 特 别 是 在 构建 某 种 跟 踩 应 用 程序 时 。 
解决 的 办 法 很 简单 。 为 了 阻止 内 置 的 Messaging 应 用 程序 处 理 传 入 的 消息 。 应 用 程序 
只 需要 在 Messaging 应 用 程序 之 前 处 理 该 消息 。 为 此 ， 在 <intent-filter> 元 素 中 添加 
android:priority 属性 ， 如 下 所 示 : 
«receiver android:name-".SMSReceiver"» 
«intent-filter android:priority="100"> 
«action android:name- 
"android.provider.Telephony.SMS RECEIVED" /» 
«/intent-filter» 
</receiver> 
将 这 个 属性 设 为 一 个 比较 大 的 数字 ， 例 如 100. BEEK, Android 就 会 越 早 执行 您 的 
应 用 程序 。 当 收 到 传 入 的 消息 时 ， 您 的 应 用 程序 将 首先 执行 ， 此 时 您 可 以 决定 怎么 处 理 消 
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eo 为 了 防止 其 他 应 用 程序 看 到 此 消 县 ,只 需要 在 BroadReceiver 类 中 调用 abortBroadcast() 
方法 : 


@Override 
public void onReceive (Context context, Intent intent) 
{ 

//---get the SMS message passed in--- 

Bundle bundle = intent.getExtras(); 

SmsMessage[|] msgs = null; 

String str — "SMS from "; 

if (bundle !- null) 


1 
//---retrieve the SMS message received--- 
Object[] pdus = (Object[]) bundle.get ("pdus"); 
msgs — new SmsMessage[pdus.length]; 
for (int 1-0; i<msgs.length; itt) { 
msgs[i] = SmsMessage.createFromPdu ( (byte[])pdus[i]); 
if (i--0) { 
//---get the sender address/phone number--- 
str += msgs[i].getOriginatingAddress(); 
fae qe Mg Ws 
} 
//---get the message body--- 
str += msgs[i].getMessageBody () .toString(); 
} 
//---display the new SMS message--- 
Toast.makeText(context, str, Toast.LENGTH SHORT).show(); 
Loq.d("SMSReceiver", str); 
//---stop the SMS message from being broadcasted--- 
this.abortBroadcast(); 
] 


} 
这 样 ， 其 他 任何 应 用 程序 都 不 会 收 到 您 的 SMS 3H EL. 


O 注意 : 在 设备 上 安装 了 前 面 这 个 应 用 程序 后 ， 所 有 传 入 的 SMS 消息 都 将 被 这 
个 应 用 程序 拦截 ， 再 也 不 会 出 现在 Messaging 应 用 程序 中 。 


2. 通过 BroadcastReceiver 更 新 一 个 活动 


上 一 节 介 绍 了 如 何 使 用 一 个 BroadcastReceiver 类 侦 听 传 入 的 SMS 消 县 ， 然 后 使 用 Toast 
类 来 显示 接收 到 的 SMS 消息 。 通 党 情况 下 ， 您 想 要 将 SMS 消息 发 回 给 应 用 程序 的 主 活动 。 
例如 ， 您 可 能 希望 消息 在 一 个 TextView 中 显示 。 下 和 面 的 “ 试 一 试 ” 将 告诉 您 如 何 做 到 这 一 点 。 
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PE 创建 一 个 基于 视图 的 应 用 程序 项 目 
(1) 使 用 在 前 一 节 所 创建 的 同一 个 项 目 ， 在 main.xml 文件 中 添加 下 列 粗 体 显 示 的 行 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btnSendSMSs" 
android: layout width="fill parent" 
android: layout height="wrap content" 
android:text="Send SMS" 
android:onClick="onClick" /> 


<TextView 
android: id="@+id/textView1" 
android: layout width-"wrap content" 
android: layout height="wrap content" /> 


</LinearLayout> 


(2) YE SMSReceiverjava 文件 中 添加 下 列 粗 体 显示 的 语句 : 
package net.learn2develop.SMS; 


import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.os.Bundle; 

import android.telephony.SmsMessage; 
import android.util.Log; 

import android.widget.Toast; 


public class SMSReceiver extends BroadcastReceiver 
{ 
@Override 
public void onReceive (Context context, Intent intent) 
{ 
//---get the SMS message passed in--- 
Bundle bundle - intent.getExtras(); 
SmsMessage[] msgs - null; 
String str = "SMS from "; 
if (bundle !- null) 
{ 
//---retrieve the SMS message received--- 
Object[] pdus = (Object[]) bundle.get("pdus"); 
msgs = new SmsMessage[pdus.length]; 
for (int i-0; i<msgs.length; i++){ 
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msgs[i]-SmsMessage.createFromPdu((byte[]|)pdus[il); 
if (i==0) { 
//---get the sender address/phone number--- 
str += msgs[i].getOriginatingAddress(); 
str += ": "; 
} 
//---get the message body--- 
str += msgs[i].getMessageBody().toString(); 
} 
//---display the new SMS message--- 
Toast.makeText (context, str, Toast.LENGTH SHORT) .show(); 
Log.d("SMSReceiver", str); 
/ / --- send a broadcast intent to update the SMS received in the 
activity--- 
Intent broadcastIntent = new Intent(); 
broadcastIntent.setAction("SMS RECEIVED ACTION"); 
broadcastIntent.putExtra("sms", 
context.sendBroadcast(broadcastIntent); 


str); 


(3) 在 SMSActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.SMS; 


public 


android.app.Activity; 
android.app.PendingIntent; 
android.content.BroadcastReceiver; 
android.content.Context; 
android.content.Intent; 
android.content.IntentFilter; 
android.os.Bundle; 


android.telephony.SmsManager; 
android.view.View; 
android.widget.TextView; 
android.widget.Toast; 


class SMSActivity extends Activity { 


String SENT = "SMS SENT"; 
String DELIVERED = "SMS DELIVERED"; 


PendingIntent sentPI, 
BroadcastReceiver smsSentReceiver, 


deliveredPI; 
smsDeliveredReceiver; 


IntentFilter intentFilter; 


private BroadcastReceiver intentReceiver 


new BroadcastReceiver() { 
QOverride 
public void onReceive(Context context, Intent intent) { 


//---display the SMS received in the TextView--- 
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TextView SMSes = (TextView) findViewBylId(R.id.textView1) ; 
SMSes.setText(intent.getExtras().getString("sms")); 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


sentPI = PendingIntent.getBroadcast (this, 0, 
new Intent (SENT), 0); 


deliveredPI = PendingIntent.getBroadcast (this, 0, 
new Intent (DELIVERED), 0); 


//---intent to filter for SMS messages received--- 
intentFilter = new IntentFilter(); 
intentFilter.addAction("SMS RECEIVED ACTION") ; 


@Override 
public void onResume() { 
super.onResume (); 


//---register the receiver--- 
registerReceiver (intentReceiver, intentFilter); 


//---create the BroadcastReceiver when the SMS is sent--- 
smsSentReceiver = new BroadcastReceiver () { 
@Override 
public void onReceive (Context arg0, Intent argl) { 
switch (getResultCode () ) 
{ 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS sent", 
Toast.LENGTH SHORT).show(); 
break; 
case S5msManager.RESULT ERROR GENERIC FAILURE: 


Toast.makeText(getBaseContext(), "Generic failure", 


Toast.LENGTH SHORT) .show(); 
break; 
case smsManager.RESULT ERROR NO SERVICE: 
Toast.makeText(getBaseContext(), "No service", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager.RESULT ERROR NULL PDU: 
Toast.makeText(getBaseContext(), "Null PDU", 
Toast.LENGTH SHORT).show(); 
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break; 
case 5msManager.RESULT ERROR RADIO OFF: 
Toast.makeText(getBaseContext(), "Radio off", 
Toast.LENGTH SHORT) .show(); 


break; 
} 
} 
be 
//---create the BroadcastReceiver when the SMS is delivered--- 
smsDeliveredReceiver = new BroadcastReceiver()í 


@Override 
public void onReceive (Context argÜ, Intent argl) { 
switch (getResultCode () ) 
{ 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS delivered", 
Toast.LENGTH SHORT).show(); 
break; 
case Activity.RESULT CANCELED: 


Toast.makeText (getBaseContext(), "SMS not delivered", 


Toast.LENGTH SHORT).show(); 
break; 


//---register the two BroadcastReceivers--- 

registerReceiver(smsDeliveredReceiver, new IntentFilter 
(DELIVERED)); 

registerRecelver (smsSentReceiver, new IntentFilter(SENT)); 


aOverride 
public void onPause() { 
super.onPause(); 


//---unregister the receiver--- 
unregisterReceiver (intentReceiver); 


//---unregister the two BroadcastReceivers--- 


unregisterReceiver(smsSentReceiver); 
unregisterReceiver(smsDeliveredReceiver); 


public void onClick(View v) { 
sendSMS ("5556", "Hello my friends!"); 


public void onSMSIntentClick (View v) { 
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//--sends an SMS message to another device; 
private void sendSMS(String phoneNumber, 


Intent i = new 
Intent (android.content.Intent.ACTION VIEW); 
i.putExtra(l aduress", "5556; 5558; 2560"); 
i.putExtra("sms body", "Hello my friends!"); 
i.setType ("vnd.android-dir/mms-sms"); 


startActivity (i); 


String message) 


SmsManager.getDefault(); 


smsManager sms = 
null, message, sentPI, 


sms.sendTextMessage (phoneNumber, 


deliveredPI); 


(4) f£ F11 键 在 Android RAM 28 UA REAP. 使 用 DDMS I8] BU. a8 ACIS 


消息 。 图 8-5 展示 了 分 别 由 Toast 类 和 TextView 所 显示 的 收 到 的 消息 。 
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Send SMS 


SMS trom 5556: This ts a long SMS message that 
is longer than 160 characters. As you can see, | 
have nothing much to say here except to type in 
as many useless words as possible so that | can 
exceed the 160 characters limit. OK, looks like | 
have exceeded the limit. :-) 


SMS from 5556: This is a long SMS 
message that is longer than 160 = p — 一 

characters. As you can see, | have nothing |. [e 
much to say here except to type in as m a 一 一 一 ri 
many useless words as possible so that I T aic 


can exceed the 160 characters limit. OK, 
looks like | have exceeded the limit. :-) 


图 8-5 


-条 SMS 
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示例 襄 明 

首先 在 活动 中 添加 一 个 TextView， 可 以 用 它 来 显示 接收 到 的 SMS 消息 。 

接 下 来 修改 SMSReceiver 类 。 这 样 当 它 接收 到 一 条 SMS 消息 时 ， 将 广播 另 一 个 Intent 
对 象 ， 使 得 侦 听 这 一 意图 的 任何 应 用 程序 可 以 得 到 通知 (我 们 接 下 来 将 在 活动 中 实现 )。 收 
到 的 SMS 也 将 通过 这 个 意图 发 送出 去 。 


//---send a broadcast intent to update the SMS received in the activity--- 
Intent broadcastIntent = new Intent(); 
broadcastIntent.setAction("SMS RECEIVED ACTION"); 
broadcastIntent.putExtra("sms", str); 

context.sendBroadcast (broadcastIntent); 


下 一 步 ， 在 活动 中 创建 一 个 BroadcastReceiver 对 象 来 侦 听 广播 意图 : 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() { 
@Override 
public void onReceive (Context context, Intent intent) { 
//---display the SMS received in the TextView--- 
TextView SMSes = (TextView) findViewById(R.id.textViewl); 
SMSes.setText(intent.getExtras().getString("sms")); 


); 


当 收 到 一 个 广播 意图 时 ， 更 新 TextView 中 的 SMS 消息 。 
您 需要 创建 一 个 IntentFilter 对 象 以 便 侦 听 一 个 特定 的 意图 。 这 里 , 意图 是 SMS RECEIVED _ 
ACTION: 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


sentPI = PendingIntent.getBroadcast(this, 0, 
new Intent(SENT), 0); 


deliveredPI = PendingIntent.getBroadcast(this, 0, 
new Intent(DELIVERED), 0); 


//---intent to filter for SMS messages received--- 
intentFilter = new IntentFilter(); 
intentFilter.addAction("SMS RECEIVED ACTION"); 
} 
最 后 ， 在 活动 的 onResume0 事 件 中 注册 BroadcastReceiver, ft onPause0 事 件 中 进行 注销 : 
QOverride 
protected void onResume() { 


//--register the receiver-- 
registerReceiver(intentReceiver, intentFilter); 
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super .onResume () ; 


| 


@Override 

protected void onPause() { 
//--unregister the receiver-- 
unregisterReceiver (intentReceiver) ; 
super.onPause(); 


} 


QOverride 
public void onResume() { 
super.onResume () ; 


//---register the receiver--- 
registerReceiver(intentReceiver, intentFilter) ; 


//---create the BroadcastReceiver when the SMS is sent--- 
"rm 

} 

@Override 


public void onPause() { 
super.onPause(); 


//---unregister the receiver--- 
unregisterReceiver (intentReceiver); 


//-——-unregister the two BroadcastReceivers--- 
Kf ass 
) 
这 意味 者， 只 有 在 收 到 SMS 消息 且 活 动 在 屏幕 上 可 见 时 ，TextView 7 SH Re 
如 果 接 收 到 SMS 消息 时 活动 不 在 前 台 ，TextView 将 不 会 被 更 新 。 


3. 通过 BroadcastReceiver 调用 一 个 活动 


前 面 的 示例 说 明了 如 何 传递 接收 到 的 SMS 消息 来 在 活动 中 显示 。 然 而 ， 在 许多 情况 
下 ， 当 接收 SMS 消 县 时 活动 可 能 在 后 台 。 在 这 种 情况 下 ， 当 接收 一 条 消息 时 ， 如 果 能 将 活 


动 推 到 前 台 将 是 很 有 用 的 。 下 面 的 “ 试 一 试 ”展示 了 该 如 何 做 到 这 一 点 。 
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a) 使 用 在 前 一 节 所 创建 的 同一 个 项 目 , 在 SMSActivityjava 文件 中 添加 下 列 粗 体 显示 
的 行 : 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


sentPI = PendingIntent.getBroadcast(this, 0, 
new Intent(SENT), 0); 


deliveredPI = PendingIntent.getBroadcast(this, 0, 
new Intent(DELIVERED), 0); 


//---intent to filter for SMS messages received--- 
intentFilter = new IntentFilter(); 
intentFilter.addAction("SMS RECEIVED ACTION"); 


//---register the receiver--- 
registerReceiver(intentReceiver, intentFilter) ; 


@Override 
public void onResume() { 
super.onResume () ; 


//---register the receiver--- 
//registerReceiver(intentReceiver, intentFilter); 


//---create the BroadcastReceiver when the SMS is sent--- 
smsSentReceiver = new BroadcastReceiver()í 
@Override 
public void onReceive (Context argÜ, Intent argl) { 
switch (getResultCode () ) 
{ 
case Activity.RESULT OK: 
Toast.makeText(getBaseContext(), "SMS sent", 
Toast.LENGTH SHORT).show(); 
break; 
case S5msManager.RESULT ERROR GENERIC FAILURE: 
Toast.makeText(getBaseContext(), "Generic failure", 
Toast.LENGTH SHORT).show(); 
break; 
case SmsManager.RESULT ERROR NO SERVICE: 
Toast.makeText(getBaseContext(), "No service", 
Toast.LENGTH SHORT).show(); 
break; 
case sSmsManager.RESULT ERROR NULL PDU: 
Toast.makeText(getBaseContext(), "Null PDU", 
Toast.LENGTH SHORT).show(); 
break; 
case 5msManager.RESULT ERROR RADIO OFF: 
Toast.makeText(getBaseContext(), "Radio off", 
Toast.LENGTH SHORT).show(); 
break; 
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//---create the BroadcastReceiver when the SMS is delivered--- 
smsDeliveredReceiver = new BroadcastRecelver () { 
@Override 
public void onReceive (Context argÜ, Intent argl) { 
switch (getResultCode () ) 
{ 
case Activity.RESULT OK: 
Toast .makeText (getBaseContext(), "SMS delivered", 
Toast.LENGTH SHORT) .show(); 
break; 
case Activity.RESULT CANCELED: 
Toast.makeText(getBaseContext(), "SMS not delivered", 
Toast.LENGTH SHORT).show(); 
break; 


//---register the two BroadcastReceivers--- 

registerReceiver(smsDeliveredReceiver, new IntentFilter 
(DELIVERED) ) ; 

registerReceiver(smsSentReceiver, new IntentFilter (SENT) ); 


@Override 
public void onPause() { 
super.onPause(); 


//---unregister the receiver--- 
//unregisterReceiver (intentReceiver) ; 


//---unregister the two BroadcastReceivers--- 
unregisterReceiver(smsSentReceiver); 
unregisterReceiver (smsDeliveredReceiver); 


@Override 
protected void onDestroy() { 
super.onDestroy () ; 


//---unregister the receiver--- 
unregisterReceiver (intentReceiver) ; 


(2) 在 SMSReceiver.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


@Override 
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public void onReceive (Context context, Intent intent) 
{ 
//---get the SMS message passed in--- 
Bundle bundle = intent.getExtras(); 
smsMessage[] msgs = null; 
String str = "SMS from "; 
if (bundle != null) 
{ 
//---retrieve the SMS message received--- 
Object[] pdus = (Object[]) bundle.get ("pdus"); 
msgs = new SmsMessage[pdus.length]; 
for (int i-0; i<msgs.length; itt) { 
msgs[i] = SmsMessage.createFromPdu ( (byte[])pdus[i]); 
if (i==0) { 
//---get the sender address/phone number--- 
str += msgs[i].getOriginatingAddress(); 
str += wi €": 
} 
//---get the message body--- 
str += msgs[i]l.getMessageBody ().toString(); 
} 
//---display the new SMS message--- 
Toast.makeText(context, str, Toast.LENGTH SHORT).show(); 
Log.d("SMSBeceiver", Str); 


//---launch the SMSActivity--- 

Intent mainActivityIntent — new Intent(context, SMSActivity. 
class); 

mainActivityIntent.setFlags(Intent.FLAG ACTIVITY NEW TASK); 

context.startActivity (mainActivityIntent); 


//---send a broadcast intent to update the SMS received 
in the activity--- 

Intent broadcastIntent - new Intent(); 
broadcastIntent.setAction("SMS8 RECEIVED ACTION"); 
broadcastIntent.putExtra("sms", str); 
context.sendBroadcast (broadcastIntent); 


(3) 按 如 下 所 示 修 改 AndroidManifest xml 文件 : 


<activity 
android: label="@string/app name" 
android:name-".SMSActivity" 
android:launchMode-"singleTask" > 
«intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
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(4) T£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 当 SMSActivity 显示 时 ， 单 击 Home 
按钮 将 活动 发 送 到 后 台 。 
(5) 使 用 DDMS 再 次 向 模拟 器 发 送 一 条 SMS 消息 。 这 一 次 ， 注 意 活动 将 被 推 到 前 台 ， 
显示 接收 的 SMS 消息 。 
zT Dii BH 
在 SMSActivity 类 中 ， 首 先 在 活动 的 onCreate( ) 事 件 而 不 是 onResume( ) 事 件 中 注册 
BroadcastReceiver， 并 在 onDestroy0 事 件 而 不 是 onPause0 事 件 中 进行 注销 。 这 确保 了 活动 
即使 是 在 后 台 ， 它 仍 能 够 侦 听 广播 意图 。 
接 下 来 ， 修 改 SMSReceiver 类 中 的 onReceive0 事 件 ， 在 广播 男 一 个 意图 之 前 使 用 一 个 
意图 将 活动 推 到 前 台 : 
//---launch the SMSActivity--- 
Intent mainActivityIntent = new Intent(context, SMSActivity.class) ; 


mainActivityIntent.setFlags(Intent.FLAG ACTIVITY NEW TASK) ; 
context.startActivity (mainActivityIntent); 


/ / - send a broadcast intent to update the SMS received in the activity--- 
Intent broadcastIntent - new Intent(); 
broadcastIntent.setAction("SMS RECEIVED ACTION"); 
broadcastIntent.putExtra("sms", str); 

context.sendBroadcast (broadcastIntent); 


startActivity0 方 法 启动 活动 ， 并 将 它 推 到 前 台 。 注 意 ， 需 要 设置 IntentFLAG ACTIVITY _ 
NEW TASK 标志 ， 因 为 从 一 个 活动 上 下 文 的 外 部 调用 startActivity0 需 要 FLAG ACTIVITY _ 
NEW_TASK 标志 。 
还 需要 将 AndroidManifest.xml 文件 中 <activity> 元 素 的 launchMode 属性 设置 为 
singleTask: 
<activity 
android: label="@string/app name" 
android:name=".SMSActivity" 
android: launchMode="singleTask" > 
如 果 不 进 行 设 置 ， 在 应 用 程序 收 到 SMS 消息 时 ， 将 启动 活动 的 多 个 实例 。 
注意 在 这 个 示例 中 ， 当 活动 在 后 台 时 (如 单 击 Home 按钮 来 显示 主屏 幕 )， 随 独 SMS 1H 
县 的 接收 , 活动 将 被 推 到 前 台 并 且 TextView 得 到 更 新 。 但是, 如 果 活 动 被 终止 (如 单 击 Back 
按钮 来 销毁 它 )， 活 动 会 再 次 启动 ， 但 TextView 不 会 被 更 新 。 


8.1.5 说 明和 警告 


虽然 发 送 和 接收 SMS 消息 的 能 力 使 Android 成 为 开发 复杂 应 用 程序 的 一 个 非常 引 人 注 
目的 平台 , 但 这 种 灵活 性 是 要 付出 代价 的 。 貌似 无 害 的 应 用 程序 可 能 在 幕后 发 送 SMS 消息 
而 用 户 对 此 一 无 所 知 。 正如 最 近 一 个 基于 SMS 的 Android 木马 程序 的 例子 http://forum.vodafone. 
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co.nz/topic/5719-android-sms-trojan-warning 仆 ， 该 应 用 程序 上 自称 是 一 个 媒体 播放 器 ， 但 是 一 
日 安装 ， 它 将 同一 个 收费 昂贵 的 号 码 发 送 SMS 消息 ， 导 臻 用户 产 生 巨 额 话费 。 

尽管 用 户 需 要 显 式 地 将 权限 (例如 访问 Intemet、 发 送 和 接收 SMS 消息 等 ) 授 予 应 用 程 
序 ， 但 也 仅仅 是 在 安装 时 才 显 示 对 权限 的 请 求 。 如 果 用 户 单 击 Install 按钮 ， 他 或 她 将 被 认 
为 授予 了 权限 ， 人 允许 应 用 程序 发 送 和 接收 SMS 消息 。 这 是 很 危险 的 ， 因 为 在 应 用 程序 安装 
后 ， 它 可 以 发 送 和 接收 SMS 消息 ， 而 不 再 给 用 户 任何 提示 。 

此 外 ， 应 用 程序 还 可 以 “ 嗅 探 ” 传 入 的 SMS 消息 。 例 如 ， 在 前 一 节 所 学 到 的 技术 基 
础 上 ， 可 以 很 容易 地 编写 出 检查 SMS 消息 中 茶 些 关键 字 的 应 用 程序 。 当 SMS YALE 
在 查找 的 关键 字 时 ， 可 以 使 用 Location Manager( 将 在 第 9 章 中 讨论 ) 来 获取 您 的 地 理 位 置 ， 
然后 给 SMS 消 奶 的 发 送 者 发 回 坐 标 。 这样， 这 个 发 送 者 就 可 以 很 容易 地 追踪 您 的 位 置 。 所 
有 这 些 任务 都 可 以 很 容易 地 在 您 一 无 所 知 的 情况 下 完成 ! 也 就 是 说 ， 用 户 应 该 尽量 避免 安 
装 来 历 不 明 (例如 来 自 未 知 的 网 站 、 陌 生 人 等 ) 的 Android 应 用 程序 。 


8.2 发 送 电子 邮件 


与 SMS 消息 传递 类 似 ，Android 还 文 持 电子 邮件 。Android 上 的 Gmail/Email 应 用 程序 
可 以 使 您 使 用 POP3 或 IMAP 来 配置 电子 邮件 账户 。 除 了 使 用 Gmail/Email 应 用 程序 发 送 
和 接收 电子 邮件 外 , 还 可 以 通过 编程 方式 从 Android 应 用 程序 中 发 送 电子 邮件 。 下 面 的 “ 试 
一 试 ” 将 告诉 您 如 何 做 。 


以 编程 方式 发 送 电子 邮件 


Emails.zip fCfZ X ff a] CUTE Wrox.con E F 


(1) 打开 Eclipse， 创 建 一 个 名 为 Emails 的 新 的 Android Jil H . 
(2) YE main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 来 百 换 TextView: 


<?xml version-"1.0" encoding-"utfí-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android: id="@+id/btnSendEmail" 
android: layout width="fill parent" 
android: layout height-"wrap content" 
android: text="Send Email" 
android: onClick="onClick" /> 


</LinearLayout> 
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(3) 在 SMSActivityjava 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Emails; 


import android.app.Activity; 
import android.content.Intent; 
import android.net.Uri; 

import android.os.Bundle; 
import android.view.View; 


public class EmailsActivity extends Activity [| 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


public void onClick(View v) { 
//---replace the following email addresses with real ones--- 
String[] to = 
{"someguy@example.com", 
"anotherguy@example.com" } ; 
String[] cc = {"busybodylCexample.com"}; 
sendEmail (to, cc, "Hello", "Hello my friends!") ; 


//---sends an SMS message to another device--- 

private void sendEmail (String[] emailAddresses, String[] carbonCopies, 

String subject, String message) 

{ 
Intent emailIntent = new Intent(Intent.ACTION SEND); 
emailIntent.setData(Uri.parse("mailto:")); 
String[] to = emailAddresses; 
String[] cc - carbonCopies; 
emailIntent.putExtra(Intent.EXTRA EMAIL, to); 
emailIntent.putExtra(Intent.EXTRA CC, cc); 
emailIntent.putExtra(Intent.EXTRA SUBJECT, subject); 
emailIntent.putExtra(Intent.EXTRA TEXT, message); 
emailIntent.setType ("message/rfc822") ; 
startActivity (Intent.createChooser(emailiIntent, "Email")); 


} 


(4) T£ F11 键 在 Android 模拟 器 /设备 上 调试 应 用 程序 (确保 在 尝试 这 个 示例 之 前 配置 了 
电子 邮件 )。 单 击 Send Email 按钮 可 以 看 到 在 模拟 器 /设备 上 启动 了 Email 应 用 程序 ， 如 图 
8-6 所 示 。 
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Compose — 


From weimenglee@gmail.com 


<someguy@yourcompany.com-, 
<anotherguy@yourcompany.com=>, 


<busybody@yourcompany.com>, 
Bcc 
Hello 


| Hello my friends! 


关于 测试 电子 邮件 的 一 点 提示 


如 果 您 是 一 名 Gmail 的 用 户 ， 那 么 在 进行 测试 时 ， 可 以 利用 这 一 事实 : 可 以 在 账户 的 


用 户 名 后 使 用 加 号 (+) 和 任何 字符 串 。 此 时 ， 仍 然 可 以 接收 电子 邮件 ， 但 好 处 是 可 以 进行 第 
选 。 例 如 ， 本 书 作 者 的 Gmail 账户 是 Weimenglee@gmail.com。 在 进行 测试 时 ， 作 者 会 把 收 
件 人 地 址 配置 为 weimengleetandroid book@gmail.com。 这 样 就 很 容易 筛选 出 这 些 消息 , 方 
便 以 后 删除 。 另 外 ， 还 可 以 在 Gmail 地 址 中 加 入 点 号 。 例 如 ， 如 果 想 要 测试 发 送 一 封 电子 
邮件 给 多 个 人 ， 可 以 发 送 到 weimeng.lee@gmailcom、wei.meng.lee(@email.com 和 wei.menglee@ 
gmailcom， 发 给 这 些 地 址 的 电子 邮件 最 终 都 会 作为 一 个 单独 的 消息 发 送 到 作者 的 账户 
weimenglee@gmail.com 中 。 这 对 于 测试 很 有 帮助 。 
最 后 ， 看 一 看 http://smtp4dev.codeplex.com， 上 面包 含 了 很 多 虚拟 的 SMTP 服务 器 ， 

可 用 于 调试 电子 邮件 消息 。 


示例 说 明 
在 这 个 示例 中 , JAA AY Email 应 用 程序 来 发 送 一 封 电子 邮件 消 有 息 。 要 做 到 这 一 点 ， 
可 以 使 用 一 个 Intent 对 象 并 使 用 setData0、putExtra0 和 setTypeO 方 法 来 设置 各 种 参数 : 


Intent emailIntent = new Intent(Intent.ACTION SEND); 
emaillIntent.setData(Uri.parse("mailto:")); 

String[] to = emailAddresses; 

String[] cc = carbonCopies; 
emaillIntent.putExtra(Intent.EXTRA EMAIL, to); 
emailIntent.putExtra(Intent.EXTRA CC, cc); 
emaillntent.putExtra(Intent.EXTRA SUBJECT, subject); 
emaillntent.putExtra(Intent.EXTRA TEXT, message); 
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emaillntent.setType("message/rfc822"); 
startActivity (Intent .createChooser(emailiIntent, "Email")); 


8.3 本草 小 结 


本 章 介 绍 了 应 用 程序 与 外 界 通 信 的 两 种 关键 的 方式 。 首先 学 习 了 如 何 发 送 和 接收 SMS 
iE. EH SMS 可 以 构建 多 种 多 样 的 依赖 于 移动 运营 商 提供 的 服务 的 应 用 程序 。 第 9 章 将 
展示 一 个 极 佳 的 例子 ， 说 明 如 何 使 用 SMS 消息 传递 构建 一 个 位 置 跟踪 应 用 程序 。 

还 学 习 了 如 何 从 Android 应 用 程序 中 发 送 电 子 邮 件 。 这 是 通过 使 用 Intent 对 象 调用 内 
‘a HY) Email 应 用 程序 实现 的 。 


1. 说 出 在 Android 应 用 程序 中 可 以 用 来 发 送 SMS 消息 的 两 种 方式 。 

2. 说 出 为 发 送 和 接收 SMS 消息 需要 在 AndroidManifest.xml 文件 中 声明 的 权限 。 
3. 如 何 通 过 BroadcastReceiver 通知 一 个 活动 ? 

练习 答案 参见 附录 C. 


本 章 主要 内 容 
主 题 关键 概念 
以 编程 方式 发 送 SMS 消息 使 用 SmsManager 类 
发 送 消息 后 获取 反馈 在 sendTextMessage0 方 法 中 使 用 两 个 PendingIntent X% 
使 用 意图 发 送 SMS 消息 意图 类 型 设置 为 vnd.android-dir/mms-sms 
接收 SMS B5 实现 一 个 BroadcastReceiver 并 在 AndroidManifest.xml 文件 中 设置 它 
使 用 意图 发 送 电子 邮件 将 意图 类 型 设置 为 message/rfc822 
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本 章 将 介绍 以 下 内 容 : 

e 如 何在 Android 应 用 程序 中 显示 Google Maps 

e 如 何在 地 图 上 显示 缩放 控件 

e 如 何在 不 同 的 地 图 视图 间 切 换 

e 如 何在 地 图 上 添加 标记 

e 如 何 获 取 在 地 图 上 触摸 的 位 置 的 地 址 

e 如 何 进行 地 理 编码 和 反 辐 地 理 编码 

e 如 何 使 用 GPS、CellL-ID 和 Wi-Fi 三 角 测 量 法 来 获取 地 理 数 据 
e 如 何 监控 一 个 位 置 

e 如 何 构建 一 个 位 置 跟踪 应 用 程序 


近 些 年 来 ， 我 们 都 看 到 了 移动 应 用 程序 的 爆炸 性 增长 。 其 中 一 类 非常 流行 的 应 用 程序 
是 基于 位 置 的 服务 ， 即 LBS. LBS 应 用 程序 跟踪 您 的 位 置 ， 并 可 提供 额外 服务 ， 如 定位 附 
近 的 便利 设施 以 及 提供 路 线 规划 建议 等 。 当 然 ，LBS 应 用 程序 中 的 一 个 关键 因素 是 地 图 ， 
它 可 以 对 您 的 位 置 进 行 可 视 化 表示 。 

本 章 中 将 学 习 如 何在 Android 应 用 程序 中 使 用 Google Maps， 以 及 如 何以 编程 方式 操 
作 它 。 此 外 ， 还 将 学 习 如 何 利 用 Android SDK 中 提供 的 LocationManager 类 获得 您 的 地 理 
位 置 。 本 章 最 后 将 建立 一 个 位 置 跟踪 应 用 程序 ， 可 以 把 它 安 装 在 一 个 Android 设备 上 ， 用 
来 使 用 SMS 消 奶 跟踪 朋友 和 杀人 的 位 置 。 


9.1 显示 地 图 
Google Maps 是 与 Android 平台 捆绑 在 一 起 的 众多 应 用 程序 之 一 。 除 了 直接 使 用 Maps 


应 用 程序 外 ， 还 可 以 将 它 竹 入 到 您 自己 的 应 用 程序 中 来 做 一 些 非常 酷 的 事情 。 本 节 介 绍 如 
何在 Android 应 用 程序 中 使 用 Google Maps 以 及 用 编程 方式 完成 以 下 功能 : 
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e 改变 Google Maps 的 视图 。 

e 在 Google Maps 中 获取 位 置 的 经 度 和 纬度 。 

e 进行 地 理 编 乌 和 反问 地 理 编码 ( 将 一 个 地 址 转换 为 经 纬度 或 反之 )。 
e 7E Google Maps 上 添加 标记 。 


9.1.1 创建 项 目 
开始 时 ， 需 要 首先 创建 一 个 Android 项 目 以 便 在 活动 中 显示 Google Maps. 
创建 Google APIS 项 目 


LBS.zip fCfZ X fF A Dl rt Wrox.com _ FE 
(1) 使 用 Eclipse, &]£ — Android 项 目 ， 命 名 为 LBS。 
O 注意 :为 了 在 Android 应 用 程序 中 使 用 Google Maps, 需要 确保 选择 Google APIs 


作为 构建 目标 。Google Maps 并 不 是 标准 Android SDK 的 一 部 分 ， 因 此 需要 在 
Google APIs 附加 组 件 中 找到 它 。 


(2) 创建 项 目 后 ， 可 以 看 到 在 Google APIs 文件 夹 下 多 出 来 一 个 JAR 文件 (maps.jar)， 
如 图 9-1 所 示 。 


8] Java - Eclipse 
File Edit Refactor Run Source Navigate Search Project Window Help | 
;n-uggoi:inguH:t*-0O-QqQ-Sc-oo25- 


ay, 


at LBS 
p (gH sre 
p cn gen [Generated Java Files] 
4 Bh Google APIs [Android 4.0] 
> [mb android, jar - E:\Android 4.0\android-sdk\platforms\android-14 
b m usb.jar - E. Android 4.0\android-sdk\add-ons\addon-google_apis-google_inc_-14\libs 
bba maps.jar - EXAndroid 4.0\android-sdk\add-ons\addon-google_apis-google_inc_-14\\ibs 
p &» bin 
b ES res 
©) AndroidManifest.xml 
>) proguard.cfg 
project.properties 


图 9-1 
示例 说 明 
这 个 简单 的 动作 创建 了 一 个 使 用 Google APIs 附加 组 件 的 Android 项 目 。Google APIs 
附加 组 件 包 括 了 标准 的 Android 库 和 USB 库 ， 以 及 打包 在 maps.jar 文件 中 的 Maps 库 。 
9.1.2 获取 Maps API *Z £8 


从 Android SDK 发 行 版 1.0 开始 ， 在 Android 应 用 程序 中 集成 Google Maps 前 需要 先 
申请 一 个 免费 的 Google Maps API 密 钥 。 当 申请 这 个 密 钥 时 , 必须 同意 Google 的 使 用 条 球 ， 
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所 以 一 定 要 仔细 阅读 。 
要 申请 一 个 密 铀 ， 可 按照 下 面 列 出 的 一 系列 步骤 进行 。 


注意 : Google 提供 的 关于 申请 MapsAPI 密 钥 的 详细 文档 参见 http;//code.google.com/ 
android/add-ons/google-apis/mapkey. html. 


首先 ， 如 果 您 正在 直接 连接 到 您 的 开发 机 的 Android 模拟 器 或 Android 设备 上 进行 应 用 程 
序 测 试 , 则 需要 在 默认 文件 严 ( 对 于 Windows 7 的 用 户 来 说 是 C:\User\<username>\.android) FER 
到 SDK 调试 证 书 。 您 可 以 进入 Eclipse 并 选择 Window | Preferences 来 验证 调试 证 书 是 否 存在 。 
展开 Android 项 , 并 选择 Build( 如 图 9-2 所 示 )。 在 窗口 的 右 侧 , 可 以 看 到 调试 证 书 押 在 的 位 置 。 


注意 : 对 于 Windows XP 用 户 来 说 ， 默 认 的 Android 文件 夹 是 C:\Documents 
A and Settings\<username>\Local Settings\Application Data\Android. 


e Preferences [一 [i 


type filter text Build 


» General 
rer Build Settings: 


Build Automatically refresh Resources and Assets folder on build 
DDMS |J! | Force error when external jars contain native libraries 
Editors l Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch Build output 
LogCat © Silent 
Usage Stats 
> Ant 
» Data Management 
> Help 
» Install/Update 
» Java Custom debug keystore: 
> Java EE 


» Java Persistence 
> JavaScript Restore Defaults Apply 


D Norrnal 


三) Verbose 


图 9-2 

调试 密 钥 库 的 文件 名 为 debug.keystore。 这 是 Eclipse 用 来 为 应 用 程序 进行 签名 的 证 书 ， 
以 便 应 用 程序 可 以 在 Android 模拟 右 或 设备 上 运行 。 

使 用 调试 密 钥 库 ， 需 要 使 用 安装 IDK 时 包含 的 keytool.exe 应 用 程序 来 提取 其 MDS 指 
纹 。 这 个 指纹 是 用 来 申请 免费 Google Maps EHI]. 338 35$ n] DATE C:\Program Files\Java\<JDK_ 
version number>\bin 文件 夹 下 找到 keytool.exe. 

发 出 以 下 命令 (如 图 9-3 所 示 ) 来 提取 MDS 指纹 : 

keytool.exe -list -alias androiddebugkey -keystore 


“C:\Users\<username>\.android\debug.keystore” -storepass android 
-keypass android -v 
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cs C bad MÀ stem32\cmd.exe 


G:\ Program Piles*Jaua*jre65*hin»keutool.exe —list -alias androiddebugkeu —-keystor 
e "C:xslsers*uUei-Meng Lee*.android*debug.keustore" -storepass android -keypass an 
droid —u 
Alias name: androiddebugkey 
Creation date: Jul 4. 2611 
Entry type: Privatekeubntru 
Certificate chain length: 1 
Certificate [i]: 
Quner: CN=Android Debug. O-ündroid. C=US 
Issuer: CH-ündroid Debug. v= Android, C=U§8 
Serial number: 4e11b3?d 
- Mon Jul 84 20: 35:09 SGT 2611 until: Tue Jul H3 28:35:89 SGT 2612 


DS: Gz 67: FCE: 38:82:C3:58:088:88:2D:CE:56:27:88:58:EB 
Dy?:12:r3j-5D:D3i-4H-UD-1HUCBb:BN85:H4-57:5477B-78Y 7205 87: DE: 62 :5F 

Signature algorithm name: SHüiwithRSfh 

Vers ion: 


C:\Program Files*Jaua*jre6*bin?., 


图 9-3 


在 这 个 例子 中 ， 我 的 MDS 指纹 是 5C:67:CE:30:82:C3:58:08:88:2D:CE:56:27:80:50:EB. 
在 前 面 的 命令 中 ， 使 用 了 如 下 参数 : 


-list 一 一 显示 关于 指定 密 钥 库 的 详细 信息 。 
-alias 一 一 密 钥 库 的 别名 ， 对 于 debug.keystore 是 androiddebugkey. 


-keystore 一 一 指定 密 钥 库 的 位 置 。 
指定 密 钥 库 的 密码 ， 对 于 debug.keystore 是 android. 
指定 密 钥 库 中 密 钥 的 密码 ， 对 于 debug.keystore 是 android. 


-storepass 


-keypass 


m MD5 证 书 指纹 并 将 Web 浏览 器 转 到 AGREE 
html。 按 照 页 面 上 的 指令 完成 申请 并 获取 Google Maps 密 钥 。 当 这 一 切 完成 后 ， 束 应 该 可 
以 看 到 如 图 9-4 所 示 的 类 似 信息 。 


A Android Maps API- Thank = | 


-o © werw.googlecom/gim/mmap/a/apirtp 


Google 9:9 Mars An 


Google Code Home > Google Maps API > Google Maps AFI Sign-Up 


Thank you for signing up for an Android Maps API key! 


Your key is 


This key will work for all apps signed with your certificate whose fingerprint is 


Here is a sample xml layout to get you started on your way to mapping glory: 


<com.googl android.maps.MapView 
Sane iv layout width-"fill parent" 
android: layout heighnt="fill parent" 


androüid:apiEey-"O0AeGROUwGH4pYmhcwaA9JF5mMEtrmwgFeBBobTHA" 


Have a look at the API documentation for more information 


图 9-4 
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注意 : 虽然 可 以 使 用 调试 黎 钥 库 的 MD5 指纹 来 获取 用 于 在 Android 模拟 器 或 
设备 上 调试 应 用 程序 的 Maps API 密 钥 ， 但 如 果 试 图 将 Android 应 用 程序 作为 
一 个 APK 文件 部 署 ， 密 钥 将 不 再 有 效 。 一 旦 准备 将 应 用 程序 部 署 到 Android 
Market( 或 者 使 用 其 他 发 布 方法 )， 就 需要 使 用 可 以 为 您 的 应 用 程序 进行 签名 的 
证 书 来 重新 申请 一 个 Maps API 密 钥 。 第 12 章 将 对 此 进行 详细 讨论 。 


9.1.3 显示 地 图 


现在 就 要 准备 在 Android 应 用 程序 中 显示 Google Maps 了 。 这 将 包含 两 个 主要 任务 : 
e 修改 AndroidManifest.xml 文件 ， 添 加 <uses-library> 元 素 和 INTERNET 权限 。 


e 在 您 的 用 广 


:界面 中 添加 MapView 元 素 。 


下 面 的 “ 试 一 试 ” 将 告诉 您 应 该 如 何 做 。 
显示 Google Maps 

(1) 使 用 在 前 一 节 中 所 创建 的 项 目 ， 在 mainxml 文件 中 用 下 列 粗 体 显 示 的 行 替换 
TextView( 一 定 要 用 您 先前 获取 的 API 密 钥 替换 android:apiKey 属性 的 值 ): 


<?xml version-"1.0" encoding-"utf-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: 
android: 
android: 


<com.google. 
android: 


android 


layout width="fill parent" 
layout height-"fill parent" 
orientation-"vertical" > 


android.maps.MapView 
id="@+id/mapView" 


:layout width-"fill parent" 
android: 
android: 
android: 
android: 


layout height-"fill parent" 

enabled-"true" 

clickable="true" 
apiKey-"OAeGROUwGHApYmhcwaA9JF5mMEtrmwFe8RobTHA" /> 


</LinearLayout> 


(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 行 : 


<?xml version-"1.0" encoding-"utfí-8"?» 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net.learn2develop.LBS" 


android:versionCode-"]" 


android:versionName-"1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


«uses-permission android:name-"android.permission.INTERNET"/» 


«application 


android:icon="@drawable/ic launcher" 
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android: label="@string/app name" > 
<uses-library android:name="com.google.android.maps" /> 
<activity 
android: label="@string/app name" 
android:name-".LBSActivity" > 
«intent-filter > 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category. 
LAUNCHER" /> 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 


(3) 在 LBSActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 。 注意 , LBSActivity 现在 扩展 
MapActivity 基 类 。 


package net.learn2develop.LBS; 


import com.google.android.maps.MapActivity; 
import android.os.Bundle; 


public class LBSActivity extends MapActivity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


@Override 

protected boolean isRouteDisplayed() { 
// TODO Auto-generated method stub 
return false; 


} 


(4) 4% F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 图 9-5 展示 了 在 应 用 程序 的 活动 中 
显示 的 Google Maps。 

示例 说 明 

为 了 在 应 用 程序 中 显示 Google Maps， 首 先 需要 在 清单 文件 中 拥有 INTERNET 权限 。 
然后 在 UI 文件 中 添加 <com.google.android.maps.MapView> 元 素来 把 地 图 借入 到 活动 中 。 特 
别 重 要 的 是 ， 活 动 现在 必须 扩展 MapActivity 基 类 ， 后 者 本 映 是 Activity 类 的 扩展 。 对 于 
MapActivity 类 ， 需 要 实现 一 个 方法 : isRouteDisplayed0。 这 一 方法 用 于 Google 的 计算 目 
的 ， 如 果 在 地 图 上 显示 了 路 径 信 息 ， 则 此 方法 应 返回 tue。 对 于 一 些 最 简单 的 情况 ， 可 以 
H ÆR [n] false. 
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图 9-5 
为 了 在 Android 模拟 器 上 测试 应 用 程序 ， 一 定 要 在 创建 AVD 时 选择 Google Maps API 
作为 目标 。 
如 果 看 不 到 地 图 


如 果 您 看 到 的 只 是 一 个 帝 有 网 格 的 空白 屏幕 而 没有 显示 Google Maps， 那 最 有 可 能 的 


是 在 main.xml 文件 中 使 用 了 错误 的 API 密 钥 。 还 有 可 能 是 在 AndroidManifest.xml 文件 中 
缺少 INTERNET 权限 。 最 后 ， 确 保 在 您 的 模拟 器 /设备 上 具有 Internet 访问 权限 。 

如 果 程 序 没有 运行 (也 即 程 序 骨 尝 )， 那 可 能 是 您 忘记 在 AndroidManifestxml 文件 中 添 
加 以 下 语句 : 


«uses-library android:name-"com.google.android.maps" /> 


注意 这 条 语句 在 AndroidManifest xml 文件 中 的 位 置 : 它 应 该 位 于 <Application> 元 素 内 。 
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9.1.4 显示 缩放 控件 


前 一 节 展 示 了 如 何在 Android 应 用 程序 中 显示 Google Maps。 可 以 将 地 图 平移 到 任何 
想 要 的 位 置 上 ， 地 图 能 够 随即 进行 动态 更 新 。 然 而 ， 在 模拟 器 上 是 没有 办 法 对 地 图 上 一 个 
特定 的 位 置 直接 进行 放大 或 缩小 的 (在 一 个 真正 的 Android 设备 上 ,可 以 用 手指 捏 放 地 图 进 
行 缩放 )。 因 此 ， 在 本 节 中 将 学 习 如 何 利用 内 置 的 缩放 控件 ， 使 用 户 可 以 对 地 图 进行 放大 或 
缩小 的 操作 。 


显示 内 置 的 缩放 控件 
(1) 使 用 前 一 节 创 建 的 项 目 ， 添 加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.LBS; 


import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapView; 


import android.os.Bundle; 


public class LBSActivity extends MapActivity { 
MapView mapView; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 


setContentView (R.layout.main) ; 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltlInZoomControls (true); 


@Override 
protected boolean isRouteDisplayed() { 
// TODO Auto-generated method stub 


return false; 
} 
(2) f£ F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 当 单 击 并 拖 搜 地 图 时 ， 可 以 注意 到 


在 地 图 底部 显示 的 内 置 缩放 控件 (如 图 9-6 所 示 )。 可 以 通过 单 击 减 号 (-) 图 标 缩小 地 图 ， 单 
击 加 号 (图 标 放大 地 图 。 
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图 9-6 
示例 说 明 
要 显示 内 置 的 缩放 控件 , 首先 要 获取 对 MapView 的 引用 并 调用 setBuiltmZoomControls0 方 法 : 


mapView = (MapView) findViewById (R.id.mapView); 
mapView.setBuiltInZoomControls(true); 


除了 显示 缩放 控件 ， 还 可 以 使 用 MapController 类 的 zoomInO && — 以 编程 
方式 来 实现 对 地 图 的 缩放 。 下 面 的 “ 试 一 试 ” 将 告诉 您 如 何 做 到 这 一 点 。 
i — iX 以 编程 方式 缩放 地 图 
(1) 使 用 前 一 节 创 建 的 项 目 ， 在 LBSActivityjava 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.LBS; 


import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapController; 
import com.google.android.maps.MapView; 


import android.os.Bundle; 
import android.view.KeyEvent; 


public class LBSActivity extends MapActivity { 
MapView mapView; 
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/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltInZoomControls (true); 


public boolean onKeyDown(int keyCode, KeyEvent event) 


{ 
MapController mc = mapView.getController(); 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE 3: 
mc.zoomIn(); 
break; 
case KeyEvent.KEYCODE 1: 
mc.zoomOut(); 
break; 
} 
return super.onKeyDown(keyCode, event); 
} 
@Override 


protected boolean isRouteDisplayed() { 
// TODO Auto-generated method stub 
return false; 


} 
(2) 按 F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 现 在 ， 可 以 通过 按 下 模拟 器 上 的 数 
字 键 3 来 放大 地 图 ， 按 数字 键 1 来 缩小 地 图 。 
示例 说 明 
为 了 处 理 在 活动 上 的 按键 操作 ， 需 要 处 理 onKeyDown 事件 : 


public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
MapController mc = mapView.getController(); 
switch (keyCode) 
{ 
case KeyEvent.KEYCODE 3: 
mc.zoomin(); 
break; 
case KeyEvent.KEYCODE 1: 
mc.zoomoOut (); 
break; 
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return super.onKeyDown (keyCode, event); 
} 

为 了 管理 对 地 图 的 平移 和 缩放 ， 需 要 从 MapView 对 象 中 获得 一 个 MapController 类 的 
实例 。MapController 类 包含 了 zoomIm0O 和 zoomOut0 方 法 (再 加 上 其 他 一 些 用 来 控制 地 图 的 
方法 )， 可 以 使 用 户 对 地 图 进行 放大 或 缩小 。 

注意 ， 如 果 将 应 用 程序 部 蓝 到 真实 设备 上 ， 可 能 无 法 测试 这 个 应 用 程序 的 缩放 功能 ， 
因为 现在 大 多 数 Android 设备 并 没有 物理 键盘 。 


9.1.5 改变 视图 


默认 情况 下 ，Google Maps 是 以 地 图 视图 来 显示 的 ， 它 基本 上 描绘 了 感 兴 趣 的 街道 和 
地 方 。 还 可 以 使 用 MapView 类 的 setSatellite0 方 法 将 Google Maps 设置 为 以 卫星 视图 显示 


@Override 

public void onCreate (Bundle savedInstanceState) | 
super .onCreate (savedinstanceState) ; 
setContentView(R.layout.main); 


mapView = (MapView) findViewByld(R.id.mapView) ; 
mMapView.setBuiltInZoomControls (true); 
mapView.setSatellite (true) ; 

} 


图 9-7 展示 了 以 卫 尾 视图 显示 的 Google Maps. 
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如 果 想 要 在 地 图 上 显示 交通 状况 ， 可 以 使 用 setTraffic0 方 法 : 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


mapView — (MapView) findViewById(R.id.mapView); 
mapView.setBuiltInZoomControls (true); 
mapView.setSatellite(true); 
mapView.setTraffic(true); 


} 


图 9-8 所 示 的 地 图 上 显示 了 当前 的 交通 状况 (需要 缩放 地 图 来 查看 道路 )。 不 同 的 颜色 
反映 不 同 的 交通 状况 。 一 般 来 说 ， 绿 色相 当 于 约 每 小 时 50 英里 的 车 速 ， 交 通 比 较 顺 畅 : 黄 
色相 当 于 约 每 小 时 25~50 英里 的 车 速 ， 交 通 状 况 中 等 ， 红 色相 当 于 低 于 约 每 小 时 25 英里 
的 车 速 ， 交 通 比 较 拥 堵 。 
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图 9-8 


注意 ， 只 有 美国 、 法 国 、 英 国 、 澳 大 利 亚 以 及 加 拿 大 的 主要 城市 提供 交通 状况 信息 ， 
不 过 新 的 国家 和 城市 在 不 断 加 入 。 


9.1.6 导航 到 特定 位 置 
默认 情况 下 , 当 Google Maps 首次 加 载 时 , 显示 的 是 美国 地 图 。 然而, 也 可 以 将 Google 
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Maps 设置 为 显示 一 个 特定 的 位 置 .在 这 种 情况 下 ,可 以 使 用 MapController 类 的 animateTo() 
i 
下 和 面 的 “ 试 一 试 ” 同 您 展示 了 如 何以 编程 方式 将 Google Maps 动画 显示 到 一 个 特定 位 置 。 


将 地 图 导航 到 一 个 特定 位 置 并 进行 显示 
(1) 使 用 前 一 节 创 建 的 项 目 ， 在 LBSActivityjava 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.LBS; 


import com.google.android.maps.GeoPoint; 
import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapController; 
import com.google.android.maps.MapView; 


import android.os.Bundle; 
import android.view.KeyEvent; 


public class LBSActivity extends MapActivity { 
MapView mapView; 
MapController mc; 
GeoPoint p; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltInZoomControls (true); 
mapView.setSatellite(true); 
mapView.setTraffic(true); 


mc — mapView.getController(); 

String coordinates[] = {"1.352566007", "103.78921587"); 
double lat = Double.parseDouble(coordinates[0]); 

double lng = Double.parseDouble(coordinates[1]); 


p = new GeoPoint ( 
(int) (lat * 1E6), 
(int) (lng * 1E6)); 


mc.animateTo (p); 


mc.setZzoom(13); 
mapView.invalidate(); 


public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
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IET 
} 


@Override 
protected boolean isRouteDisplayed() { 
fi. 
} 
} 
(2) 按 F11 Æ Android 模拟 器 上 调试 应 用 程序 。 当 地 图 被 加 载 后 ， 可 注意 到 它 动画 
显示 到 新 加 坡 的 一 个 特定 位 置 (如 图 9-9 R). 
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9-9 

示例 说 明 

在 前 面 的 代 人 码 中 ， 首 先 从 MapView 实例 中 获取 一 个 地 图 控制 器 并 将 其 赋 给 一 
MapController 对 象 (mc)。 然 后 使 用 一 个 GeoPoint 对 象 来 代表 一 个 地 理 位 置 。 注 意 ， 对 于 
GeoPoint 类 ， 一 个 位 置 的 经 度 和 纬度 是 用 微 度 来 表示 的 。 这 意味 看 它们 是 以 整数 值 存储 。 
例如 ， 对 于 一 个 纬度 值 40.747778， 需 要 乘 以 le6(10 H 6 KA, —A A) 8] 40747778. 

要 将 地 图 导航 到 特定 位 置 ， 可 以 使 用 MapController 类 的 animateTo()) 7}. setZoom() 
方法 可 以 用 来 指定 显示 地 图 所 采用 的 缩放 级 别 (数字 越 大 ， 地 图 上 就 能 显示 更 多 细节 )。 
invalidate() 77 1: ji i| 3 22 MapView。 
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9.1.7 ”添加 标记 

在 地 图 上 添加 标记 来 指明 感 兴 趣 的 人 位置， 这样 可 以 使 用 户 很 容易 地 定位 他 们 所 要 查找 
的 地 方 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何在 Google Maps 上 添加 标记 。 
试 一 试 在 地 图 上 添加 标记 


(1) 创建 一 个 包含 一 个 图 钉 的 GIF ARCA 9-10 所 示 )， 并 将 其 复制 到 项 目的 
res/drawable-mdpi 文件 夹 下 。 为 达到 最 好 效果 ， 将 图 像 背景 变 为 透明 ， 以 防止 添加 其 后 会 


WES Boy HE. a (> LBS 
(2) 使 用 yj 前 的 活 动 中 fil 建 的 项 日 在 »i . net.learn2develop.LBS 


i |J] LBSActivity.Java 
gen [Generated Java Files] 
oogle APIs [Android 4.0] 


- android.jar - EXAndroid 4.0\android- 


LBSActivity.java 文件 中 添加 下 列 粗 体 显 示 的 语句 : 


package net.learn2develop.LBS; 加 usbjar- E\Android 4.0\android-sdk 


jes maps.jar - E:\ Android 4.0\android-sd 


EPs - Ee 


. ] » . assets 
import java.util.List; qu 

lc res 
n ] . => classes.dex 
import om.google.android.maps.GeoPoint; | LBS.apk 
import . sd resaurces.ap. 
com.google.android.maps.MapActivity; > (E drawable-hdpi 
P > b> drawable-Idpi 
impo rt 4 EE drawable-mdpi 
com.google.android.maps.MapController; Bl (c Jouncher.png ; 
å : T | pushpin.gif ————————___-—_-_ | 本 
import com.google.android.maps.MapView; E layout 


import com.google.android.maps.Overlay; (Kj main.xml 


> [= values 

iij. AndroidManifest.xml 
|=) proquard.cfg 
project.properties 


import android.graphics.Bitmap; 


import android.graphics.BitmapFactory; 
import android.graphics.Canvas; 图 9-10 
import android.graphics.Point; 

import android.os.Bundle; 

import android.view.KeyEvent; 


public class LBSActivity extends MapActivity { 
MapView mapView; 
MapController mc; 
GeoPoint p; 


private class MapOverlay extends com.google.android.maps.Overlay 
i 

@Override 

public boolean draw(Canvas canvas, MapView mapView, 

boolean shadow, long when) 


{ 


super.draw(canvas, mapView, shadow) ; 


//---translate the GeoPoint to screen pixels--- 
Point screenPts - new Point(); 
mapView.getProjection().toPixels(p, screenPts); 
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//---add the marker--- 
Bitmap bmp = BitmapFactory.decodeResource ( 

getResources(), R.drawable.pushpin) ; 
canvas.drawBitmap (bmp, screenPts.x, screenPts.y-50, null); 
return true; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltlInZoomControls (true); 
mapView.setSatellite(true); 
mapView.setTraffic(true); 


mc — mapView.getController(); 

String coordinates[] = {"1.352566007", "103.78921587"); 
double lat = Double.parseDouble(coordinates[0]); 

double lng = Double.parseDouble (coordinates[1]); 


p = new GeoPoint( 
(int) (lat * IlEO), 
(int) (ing * 1E6)); 


mc.animateTo (p); 
mc.setzoom(13); 


//---Add a location marker--- 

MapOverlay mapOverlay = new MapOverlay(); 
List<Overlay> listOfOverlays = mapView.getOverlays(); 
listOfOverlays.clear(); 
listOfOverlays.add(mapOverlay); 


mapView.invalidate(); 


public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
FL ss 


@Override 
protected boolean isRouteDisplayed() { 
ERT 
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(3) JR F11 BETE Android 模拟 器 上 调试 应 用 程序 。 图 9-11 显示 了 添加 到 地 图 上 的 标记 。 
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示例 说 明 
为 了 在 地 图 上 添加 标记 ， 首 先 需要 定义 一 个 扩展 Overlay 类 的 类 : 


Private class MapOverlay extends com.google.android.maps.Overlay 


{ 
@Override 
public boolean draw(Canvas canvas, MapView mapView, 
boolean shadow, long when) 
{ 
eer 
} 
} 


禾 兰 代表 可 以 在 地 图 上 绘制 的 单独 的 一 项 。 可 以 添加 任意 多 个 缆 新 。 在 MapOverlay 
类 中 ， 重 写 draw0 方 法 ， reiten 特别 要 注意 的 是 ， 需 要 将 
地 理 位 置 (由 GeoPoint XJ && p 表示 ) 转 换 成 屏幕 坐标 : 


//---translate the GeoPoint to screen pixels--- 
Point screenPts = new Point(); 
mapView.getProjection().toPixels(p, screenPts); 


AIA AER ET 的 钉 尖 来 指示 地 点 的 具体 位 置 ， 所 以 需要 从 这 个 点 (如 图 9-12 所 示 ) 的 y 
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坐标 扣除 图 像 的 高 度 (50 像素 )， 并 在 该 位 置 绘制 图 像 : 


//---add the marker--- 
Bitmap bmp = BitmapFactory.decodeResource( 

getResources(), R.drawable.pushpin); 
canvas.drawBitmap (bmp, screenPts.x, screenPts.y-50, null); 


Point to draw image 
screenPts.x, screenPts.y-50 


screenPts.x, screenPts.y 
Location of point 


图 9-12 


要 添加 标记 ， 创 建 MapOverlay 类 的 一 个 实例 并 把 它 添加 到 MapView X13 HY nT HA n 
列表 中 : 
//---Add a location marker--- 
MapOverlay mapOverlay = new MapOverlay(); 
List<Overlay> listOfOverlays = mapView.getOverlays(); 
listOfOverlays.clear(); 
listOfOverlays.add(mapOverlay); 


91.8 获取 触摸 的 位 置 


使 用 Google Maps 一 段 时 间 之 后 ， 您 可 能 想 知道 刚刚 在 屏幕 上 触 碰 到 的 位 置 对 应 地 点 
的 经 纬度 。 知 道 这 个 信息 非常 有 用 ， 因 为 这 样 就 可 以 确定 一 个 位 置 的 地 址 。 这 一 过 程 被 称 
为 反 同 地 理 编 码 (我 们 将 在 下 一 节 学 习 如 何 做 到 这 一 点 )。 

如 果 已 经 在 地 图 上 添加 了 一 个 缆 兰 ,可 以 在 MapOverlay 类 中 重 写 onTouchEvent()77 X. 
每 次 用 户 触 摸 地 图 时 都 会 触发 这 一 方法 。 此 方法 有 两 个 参数 : MotionEvent 和 MapView. 
使 用 MotionEvent 参数 ， 可 以 利用 getAction0) 方 法 来 判断 用 户 是 否 已 经 从 屏幕 上 抬 起 了 他 / 
她 的 手指 。 在 下 面 的 代码 片段 中 ， 如 果 用 户 触 碰 了 屏幕 ， 随 即 又 抬 起 了 手指 ， 那 么 将 显示 
出 所 触 碰 位 置 对 应 的 经 度 和 纬度 。 

package net.learn2develop.LBS; 

import java.util.List; 

import com.google.android.maps.GeoPoint; 

import com.google.android.maps.MapActivity; 

import com.google.android.maps.MapController; 


import com.google.android.maps.MapView; 
import com.google.android.maps.Overlay; 


import android.graphics.Bitmap; 


import 
import 
import 
import 
import 
import 
import 
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android.graphics.BitmapFactory; 


android.graphics.Canvas; 


android.graphics.Point; 


android.os.Bundle; 


android.view.KeyEvent; 


android.view.MotionEvent; 


android.widget.Toast; 


public class LBSActivity extends MapActivity | 


MapView mapView; 


MapController mc; 


GeoPoint p; 


private class MapOverlay extends com.google.android.maps.Overlay 


{ 


} 


Override 


public boolean draw (Canvas canvas, MapView mapView, 


boolean shadow, long when) 


{ 
PP asa 
} 
QOverride 
public boolean onTouchEvent (MotionEvent event, MapView mapView) 
{ 
//---when user lifts his finger--- 
if (event.getAction() == 1) { 
GeoPoint p = mapView.getProjection() .fromPixels ( 
(int) event.getX(), 
(int) event.getY()); 
Toast.makeText (getBaseContext(), 
"Location: "+ 
p.getLatitudeE6() / 1E6 + "," + 
p.getLongitudeE6() /1E6 , 
Toast.LENGTH SHORT).show(); 
} 
return false; 
} 


TET 


} 


getProjection0 方 法 返回 一 个 用 于 在 屏幕 像素 坐标 和 经 纬度 坐标 之 间 进 行 转换 的 投影 。 
然后 ，fromPixels0) 方 法 将 屏幕 坐标 转换 成 GeoPoint 对 象 。 
图 9-13 展示 了 当 用 户 单 击 地 图 上 一 个 位 置 时 所 显示 的 一 组 坐标 。 
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8 5554 Android, 4.0 WithMeps 
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Location: 1.377275,103.791274 2 


图 9-13 
9.1.9 地 理 编码 和 上 反 回 地 理 编 码 


正如 前 一 节 所 述 ， 如 果 知 道 某 个 位 置 的 纬度 和 经 度 ， 就 可 Ri 
人 码 的 过 程 来 找到 它 的 地 址 。 Android 中 的 Google Maps 是 通过 Geocoder 类 来 支持 这 一 点 
下 面 的 代码 片段 展示 了 如 何 利 用 getFromLocation0 方 法 来 获取 您 rotten 


package net.learn2develop.LBS; 


import java.io.IOException; 
import java.util.List; 
import java.util.Locale; 


import com.google.android.maps.GeoPoint; 
import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapController; 


import com.google.android.maps.MapView; 
import com.google.android.maps.Overlay; 


import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.graphics.Canvas; 


import android.graphics.Point; 


import android.location.Address; 
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import 
import 
import 
import 
import 


public 
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android.location.Geocoder; 
android.os.Bundle; 
android.view.KeyEvent; 
android.view.MotionEvent; 
android.widget.Toast; 


class LBSActivity extends MapActivity I 


MapView mapView; 


MapController mc; 


GeoPoint p; 


private class MapOverlay extends com.google.android.maps.Overlay 


{ 


@Override 
public boolean draw(Canvas canvas, MapView mapView, 
boolean shadow, long when) 
{ 
PF Te 


@Override 
public boolean onTouchEvent (MotionEvent event, MapView mapView) 
{ 
//---when user lifts his finger--- 
if (event.getAction() -- 1) { 
GeoPoint p = mapView.getProjection() .fromPixels ( 
(int) event.getX(), 
(int) event.getY()); 


/* 
Toast.makeText(getBaseContext(), 

"Location: "+ 
p.getLatitudeE6() / 1E6 + "," + 
p.getLongitudeE6() /1E6 , 
Toast.LENGTH SHORT).show(); 

i 

Geocoder geoCoder - new Geocoder( 

getBaseContext(), Locale.getDefault()); 
try I 


List«Address» addresses = geoCoder.getFromLocation( 
p.getLatitudeE6() / 1E6, 
p.getLongitudeE6() / 1E6, 1); 


String add = "'""; 
if (addresses.size() > 0) 
{ 
for (int i-0;i«addresses.get(0).getMaxAddress 
LineIndex(); 
i++) 
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add += addresses.get(0).getAddressLine(i) + "Mn"; 
} 
Toast .makeText (getBaseContext () ,add,Toast.LENGTH SHORT). 
show (); 
} 
catch (IOException e) { 

e.printStackTrace(); 


} 
return true; 
} 
return false; 
} 
} 
ee 


} 


Geocoder 对 象 使 用 getFromLocation0) 方 法 将 经 度 和 纬度 转换 成 一 个 地 址 。 一 旦 获得 地 
址 之 后 , 使 用 Toast 类 来 显示 它 。 图 9-14 展示 了 应 用 程序 显示 在 地 图 上 所 触 碰 位 置 的 地 址 。 
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图 9-14 


如 果 知 道 一 个 位 置 的 地 址 ， 但 想 要 知道 它 的 经 度 和 纬度 ， 那 么 可 以 通过 地 理 编码 做 到 
一 点 。 同 样 ， 要 达到 此 目的 ， 可 以 使 用 Geocoder 类 。 下 面 的 代码 演示 了 如 何 利用 
" romLocationName() 7; ARAR Hus KEM E: 


@Override 
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public void onCreate (Bundle savedInstanceState) | 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltInZoomControls (true); 
mapView.setSatellite(true); 
mapView.setTraffic(true); 


mc — mapView.getController(); 


/* 

String coordinates[] = {"1.352566007", "103.78921587"); 
double lat = Double.parseDouble(coordinates [0]); 

double lng = Double.parseDouble(coordinates[1]); 


p = new GeoPoint( 
(int) (lat * 1E6), 
(int) (lng * 1E6)); 


mc.animateTo (p); 
mc.setZoom(13); 


*/ 


/ / ---geo-coding--- 
Geocoder geoCoder = new Geocoder(this, Locale.getDefault()); 
try { 
List<Address> addresses = geoCoder.getFromLocationName ( 
"empire state building", 5); 


if (addresses.size() > 0) { 
p = new GeoPoint ( 
(int) (addresses.get(0).getLatitude() * 1E6); 
(int) (addresses.get(0).getLongitude() * 1E6)); 
mc.animateTo (p); 
mc.setZoom(20); 
} 
} catch (IOException e) { 
e.printStackTrace(); 


//---Add a location marker--- 

MapOverlay mapOverlay - new MapOverlay(); 
List<Overlay> listOfOverlays = mapView.getOverlays(); 
listOfOverlays.clear(); 

listOfOverlays.add (mapOverlay); 


mapView.invalidate(); 
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图 9-15 显示 了 地 图 被 导航 到 季 国 大 厦 的 位 置 。 
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9.2 RETEA 


如 今 ， 移 动 设 备 普 遍 配 备 了 GPS 接收 器 。 由 于 有 许多 卫星 绕 地 球 运行 ， 因 此 使 用 GPS 
接收 器 可 以 很 容易 找到 您 所 在 的 位 置 。 然 而 ，GPS 工作 时 要 求 在 空旷 的 地 方 ， 因 此 在 室内 
或 卫星 无 法 穿 透 的 地 方 ( 如 穿山 隧道 )，GPS 常常 是 无 效 的 。 

另 一 种 用 于 定位 的 有 效 方式 是 通过 发 射 塔 三 角 测量 法 。 当 移动 电话 处 于 开机 状态 时 ， 
它 会 不 断 地 与 其 周围 的 基站 联系 。 在 知晓 发 射 塔 的 标识 后 ， 通 过 使 用 含有 发 射 塔 的 标识 和 
它们 所 处 的 确切 地 理 位 置 的 各 种 数据 库 ， 可 以 将 这 一 信息 转换 为 物理 位 置 。 发 射 塔 三 角 测 
量 法 的 优点 是 在 室内 也 起 作用 ， 无 须 获 得 来 自卫 星 的 信息 。 然 而 ， 由 于 该 方法 的 准确 性 取 
决 于 重 琵 信 号 的 覆盖 范围 ， 其 变化 相当 多 ， 因 此 它 不 如 GPS 来 得 精确 。 发 射 塔 三 角 测 量 法 
在 人 口 稠 密 地 区 最 为 有 效 ， 因 为 那里 的 发 射 塔 离 得 很 近 。 

第 三 种 定位 方法 是 依靠 Wi-Fi 三 角 测 量 法 。 设 备 连 接 到 Wi-Fi 网 络 而 不 是 连接 到 发 射 


塔 ， 并 对 照 数据 库 来 确定 服务 提供 商 押 服务 的 位 置 。 这 里 所 描述 的 3 种 方法 中 ，Wi-Fi 三 
角 测 量 法 是 最 不 准确 的 。 


Android SDK 提供 了 LocationManager 类 , 可 帮助 您 的 设备 确定 用 户 的 物理 位 置 。 下 面 
的 “ 试 一 试 ” 展 示 了 如 何 用 代码 做 到 这 一 点 。 
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将 地 图 导航 到 特定 位 置 


(1) 使 用 前 一 节 创 建 的 同一 个 项 目 , 在 LBSActivityjava 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.LBS; 


import 
import 
import 


import 
import 
import 
import 
import 


import 


import 
import 
import 
import 
import 
import 


import 
import 
import 


import 
import 
import 
import 


public 


java.io.IOException; 
java.util.List; 
java.util.Locale; 
com.google.android.maps.GeoPoint; 
com.google.android.maps.MapActivity; 
com.google.android.maps.MapController; 
com.google.android.maps.MapView; 
com.google.android.maps.Overlay; 
android.content.Context; 


android.graphics.Bitmap; 
android.graphics.BitmapFactory; 
android.graphics.Canvas; 
android.graphics. Point; 
android. location.Address; 
android. location.Geocoder; 


android. location. Location; 
android. location. LocationListener; 
android. location. LocationManager ; 


android.os.Bundle; 
android.view.KeyEvent; 
android.view.MotionEvent; 
android.widget.Toast; 


class LBSActivity extends MapActivity | 


MapView mapView; 


MapController mc; 


GeoPoint p; 


LocationManager lm; 


LocationListener locationListener; 


private class MapOverlay extends com.google.android.maps 


{ 


(fix 


/** Called when the activity is first created. */ 


@Override 


public void onCreate (Bundle savedInstanceState) { 


.Overlay 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


mapView = (MapView) findViewById(R.id.mapView); 
mapView.setBuiltInZoomControls(true); 
mapView.setSatellite(true); 
mapView.setTraffic(true); 


mc — mapView.getController(); 


/* 

String coordinates[] = ("1.352566007", "103.78921587"}; 
double lat = Double.parseDouble (coordinates[0]); 

double lng = Double.parseDouble (coordinates[1]); 


p = new GeoPoint( 
(int) (lat * I1E6), 
(int) (Ing * 1E6)); 


mc.animateTo (p); 
mc.setZzoom(13); 


EF 


/ / -——geo-coding--- 
Geocoder geoCoder = new Geocoder(this, Locale.getDefault()); 
try i 

Ifass 


//---Add a location marker--- 

MapOverlay mapOverlay = new MapOverlay(); 
List<Overlay> listOfOverlays = mapView.getOverlays(); 
listOfOverlays.clear(); 
listOfOverlays.add(mapOverlay); 


mapView.invalidate(); 
//---use the LocationManager class to obtain locations data--- 
lm = (LocationManager) 
getSystemService (Context.LOCATION SERVICE); 
locationListener = new MyLocationListener(); 
@Override 
public void onResume() { 


super .onResume () ; 


//---request for location updates--- 
im. requestLocationUpdates ( 
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LocationManager.GPS PROVIDER, 
0, 

0, 

locationListener); 


@Override 
public void onPause() { 
super.onPause(); 


//---remove the location listener--- 
lm.removeUpdates (locationListener); 


private class MyLocationListener implements LocationListener 
i 
public void onLocationChanged(Location loc) { 
if (loc '= null) { 
Toast.makeText(getBaseContext(), 

"Location changed : Lat: " + loc.getLatitude() 十 
" Lng: " + loc.getLongitude(), 
Toast.LENGTH SHORT).show(); 


p = new GeoPoint( 
(int) (loc.getLatitude() * 1E6), 
(int) (loc.getLongitude() * 1E6)); 


mc.animateTo (p); 
mc.setZzoom(18); 


public void onProviderDisabled(String provider) { 
} 


public void onProviderEnabled(String provider) { 
} 


public void onStatusChanged (String provider, int status, 
Bundle extras) { 


public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
Pie 


@Override 
protected boolean isRouteDisplayed() { 
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ffau 


} 
(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 行 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 

«uses-permission android:name-"android.permission.INTERNET"/» 
<uses-permission android:name-"android.permission.ACCESS FINE _ 
LOCATION"/» 


«application 
android:icon="@drawable/ic launcher" 
android:label-"(8string/app name" > 
«uses-library android:name-"com.google.android.maps" /» 
«activity 
android:label="@string/app name" 
android:name-".LBSActivity" > 
<intent-filter > 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 


«/intent-filter» 
Wl) DOMS - LBS/src/net/leam2develop/L BS/LBSActivity java - Eclipse 


« / activity File Edit Refactor Run Source Navigate Search Project 
E Ëa 
eget oe 


</application> 


*|aa mi 


</manifest> Marne 


| a BB ermulator-5554 Online 
(3) 4% F11 BETE Android 模拟 器 上 调试 应 用 程序 。 cena 10 


farm andenid ohana 177 


(4) 为 了 模拟 Android 模拟 器 收 到 的 GPS 数据 ， 可 以 [ne 


使 用 Eclipse 的 DDMS 透视 图 中 的 Location Controls 工具 ner on 

(如 图 9-16 所 示 )。 一 
(5) 首先 确保 已 经 在 Devices 选项 卡 中 选中 了 模拟 器 ， eae 

然后 在 Emulator Control 选项 卡 中 找到 Location Controls 工 人 


具 , 选 择 Manual 选项 卡 , 输 入 经 度 和 纬度 , 然后 单 击 Send 
按钮 。 


| Manual GPx 


(6) ELE Fy IN SE BI FRH ae E KI 308 AS 23] E Sj zs $80 23 — © Dems 


©) Sexagesimal 


个 位 置 (如 图 9-17 所 示 )。 这 证 明 应 用 程序 已 经 收 到 了 GPS enge 12200105 


Latitude — 37422006 


Ep LogCat 2i M | 


图 9-16 
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8 | 355dAndroid 40 Withhdaps - 一 一 


ETIESE 


国 emularar-5554 Online 

Sysbem_process 88 
com.android.syster 143 
com.androidinputr 157 
errs sade ehm TTD RO 

al Mi 

Il Emulator Control 3 

Telephony Stabus 


Voice: “home -| Speed: Full - 


[ aka: | home -| Latency: (Mone ~ 


Telephony Actions 
Incoming number: 


im Voice 


Imm: fenares 
a E 5 — *Park 


Location Controls 


hlanual | GPx | KL | 


& Decimal 
Location changed : Lat: 37.422005 Lng: E 3 Sexagesimal 
-122.084095 | Longitude -122.084005 
| Latitude — 37422006 


i al "ER um A 


示例 说 明 

在 Android 中 ， 基 于 位 置 的 服务 是 由 LocationManager 类 提供 的 ， 位 于 android.location 
包 中 。 使 用 LocationManager 类 ， 应 用 程序 可 以 定期 获取 设备 的 地 理 位 置 的 更 新 ， 并 在 它 
进入 某 个 位 置 附近 时 触发 一 个 意图 。 

在 LBSActivityjava 文件 中 ， 首 先 使 用 getSystemService0 方 法 获取 一 个 指 癌 Location 
Manager 类 的 引用 。 这 是 在 LBSActivity 的 onCreate0 方 法 中 完成 的 : 

//---use the LocationManager class to obtain locations data--- 


lm = (LocationManager) 
getSystemService (Context.LOCATION SERVICE); 


locationListener = new MyLocationListener () ; 


接 下 来 ， 创 建 了 MyLocationListener 类 的 一 个 实例 并 进行 了 定义 。 

MyLocationListener 类 实现 了 LocationListener 抽象 类 。 在 其 实现 中 

e onLocationChanged(Location location) 一 一 当 位 置 发 生变 化 时 调用 

e onProviderDisabled(String provider) 当 用 户 禁 用 了 提供 者 时 调用 

e onProviderEnabled(String provider) 当 用 户 启 动 了 提供 者 时 调用 

e onStatusChanged(String provider, int status, Bundle extras)—— 当 提供 者 的 状态 改变 
时 调用 


要 重 写 4 个 方法 ; 
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在 本 例 中 ， 你 对 位 置 改变 时 发 生 了 什么 更 感 兴趣 ， 因 此 在 onLocationChanged0 方 法 中 
编写 了 一 些 代 码 。 上 有 具体 来 说 ， 当 位 置 发 生变 化 时 ， 在 屏幕 上 显示 一 个 小 对 话 框 ， 给 出 新 的 
位 置信 息 : 纬度 和 经 度 。 这 个 对 话 框 是 使 用 Toast 类 显示 的 : 


public void onLocationChanged(Location loc) { 
if (loc !- null) { 
Toast.makeText (getBaseContext (), 
"Location changed : Lat: " + loc.getLatitude() + 
" Ing: " + loc.getLongitude(), 
Toast.LENGTH SHORT) .show(); 


p = new GeoPoint( 
(int) (loc.getLatitude() * 1E6), 
(int) (loc.getLongitude() * lE6)); 


mc.animateTo (p); 
mc.setzoom(18); 


) 


在 前 面 的 方法 中 ， 还 将 地 图 定位 到 接收 到 的 位 置 。 
为 了 在 位 置 发 生变 化 时 得 到 通知 ， 需 要 注册 一 个 位 置 变化 的 请 求 , 这 样 才 会 定期 地 通知 您 
的 程序 。 这 是 通过 在 活动 的 onResume0 方 法 中 使 用 requestLocationUpdates0 方 法 来 完成 的 : 
@Override 


public void onResume() { 
super.onResume () ; 


//---request for location updates--- 
lm.requestLocationUpdates( 
LocationManager.GPS PROVIDER, 
0, 
0, 
locationListener); 


} 
requestLocationUpdates0 方 法 接受 4 个 参数 : 
e provider 一 一 您 所 注册 的 服务 提供 商 的 名 称 。 在 本 例 中 , 使 用 GPS 来 获取 地 理 位 置 数据 。 
进行 通知 的 最 短 时 间 间 隅 ， 用 曝 秒 作为 单位 。0 表示 想 要 持续 得 到 位 


e minlime 


置 变化 的 通知 。 
e minDistance 进行 通知 的 最 短 距离 ， 用 米 作为 单位 。0 表示 想 要 持续 得 到 位 置 变 


化 的 通知 。 
e listeneI- 一 一 一 个 对 象 ， 在 每 一 次 位 置 更 新 时 将 调用 其 onLocationChanged0 方 法 。 
最 后 ， 在 onPause0) 方 法 中 ， 当 活动 被 销毁 或 者 进入 后 台 时 将 删除 侦 听 器 (这 样 应 用 程 
序 束 不 再 侦 听 位 置 变化 ， 从 而 节约 了 设备 的 电量 )。 这 是 使 用 removeUpdatesQ 7j 1:56 EXT] : 
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dOverride 
public void onPause() { 
super .onPause() ; 


//---remove the location listener--- 
lm.removeUpdates (locationListener); 


) 


如 果 想 使 用 Cell-ID 和 Wi-Fi 三 角 测 量 法 (对 于 宇内 使 用 很 重要 ) 获 得 您 的 位 置 数据 ， 那 
么 可 以 使 用 网 络 位 置 服务 提供 商 ， 如 下 所 示 : 


QOverride 
public void onResume() { 
super.onResume (); 


//---request for location updates--- 
lm.requestLocationUpdates ( 
LocationManager.GPS PROVIDER, 
0, 
0, 
locationListener); 


} 


为 使 用 网 络 位 置 服务 提供 商 , 需要 在 AndroidManifest.xml 文件 中 添加 ACCESS COARSE 
LOCATION 权限 : 


<?xml version-"1.0" encoding-"utf-8"?- 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 
android:versionCode-"]" 
android:versionName-"1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
«uses-permission android:name-"android.permission.INTERNET"/» 
«uses-permission 
android:name-"android.permission.ACCESS FINE LOCATION"/> 
«uses-permission 
android:name-"android.permission.ACCESS COARSE LOCATION"/» 


«application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
«uses-library android:name-"com.google.android.maps" /> 
«activity 
android: label="@string/app name" 
android:name-".LBSActivity" > 
«intent-filter > 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category. LAUNCHER" 
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/> 
«/intent-filter- 
«/activity- 
«/application» 


«/manifest» 


注意 : 在 Android 模拟 器 上 不 能 使 用 网 络 提供 商 。 如 果 在 模拟 器 上 测试 前 面 的 


在 应 用 程序 中 ， 可 以 把 GPS 位 置 服务 提 供 商 和 网 络 位 置 服务 提供 商 结合 起 来 。 


@Override 
public void onResume() { 
super.onResume () ; 


//---request for location updates--- 
lm.requestLocationUpdates( 
LocationManager.GPS PROVIDER, 
0, 
0, 
locationListener); 


//---request for location updates--- 
lm.requestLocationUpdates( 
LocationManager.NETWORK PROVIDER, 
0, 
0, 
locationListener); 


} 


然而 要 注意 , 因为 GPS 位 置 服务 提供 商 和 网 络 位 置 服务 提供 商都 会 尝试 用 自己 的 方法 
获得 位 置信 息 (GPS 与 Wi-Fi 和 Cell ID 三 角 测 量 法 )， 所 以 这 样 做 会 使 应 用 程序 收 到 两 组 不 


同 的 坐标 。 因 此 ， 在 设备 中 监视 两 个 位 置 服务 提供 商 的 状态 并 使 用 合适 的 那个 十 分 重要 。 


通过 实现 MyLocationListener 类 的 如 下 三 个 方法 ( 粗 体 显示 ), 可 以 检查 这 两 个 位 置 提供 商 的 


状态 : 


private class MyLocationListener implements LocationListener 
{ 
@Override 
public void onLocationChanged (Location loc) { 
if (loc != null) 1 
Toast.makeText(getBaseContext (), 


"Location changed : Lat: ™ + loc.getLatitude() + 


" Lng: " + loc.getLongitude(), 
Toast.LENGTH SHORT).show(); 
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P = new GeoPoint ( 
(int) (loc.getLatitude() * 1E6), 
(int) (loc.getLongitude() * l1E6)); 


mc.animateTo (p); 
mc.setZoom(18); 


//---called when the provider is disabled--- 
public void onProviderDisabled(String provider) { 
Toast.makeText(getBaseContext(), 
provider + " disabled", 
Toast.LENGTH SHORT).show(); 


//---called when the provider is enabled--- 
public void onProviderEnabled(String provider) { 
Toast.makeText(getBaseContext(), 
provider + " enabled", 
Toast.LENGTH SHORT).show(); 


//---called when there is a change in the provider status--- 
public void onStatusChanged(String provider, int status, 
Bundle extras) { 
String statusString = ""; 
switch (status) { 
case android.location.LocationProvider.AVAILABLE: 


statusString = "available"; 
case android.location.LocationProvider.OUT OF SERVICE: 
statusString = "out of service"; 
case android.location.LocationProvider.TEMPORARILY _ 
UNAVAILABLE : 
statusString = "temporarily unavailable"; 


Toast.makeText(getBaseContext(), 
provider + " " + statusString, 
Toast.LENGTH SHORT) .show() ; 


9.3 mi- NAA 


LocationManager 类 的 一 个 非常 酪 的 功能 是 它 能 够 监视 一 个 特定 的 位 置 。 这 是 使 用 
addProximityAlertO 方 法 来 实现 的 。 
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下 面 的 代码 片段 显示 了 如 何 监 控 一 个 特定 位 置 。 如 果 用 户 位 于 从 该 位 置 起 5 KAFE 
内 ， 应 用 程序 将 触发 一 个 意图 来 局 动 Web ix] vi as: 
import android.app.PendingIntent; 


import android.content.Intent; 
import android.net.Uri; 


//---use the LocationManager class to obtain locations data--- 
lm = (LocationManager) 
getSystemService(Context.LOCATION SERVICE); 


//---PendingIntent to launch activity if the user is within 
// some locations--- 
PendingIntent pendingIntent - PendingIntent.getActivity( 
this, 0, new 
Intent(android.content.Intent.ACTION VIEW, 
Uri.parse("http://www.amazon.com")), 0); 


lm.addProximityAlert(37.422006,-122.084095,5,-1,pendingIntent); 


addProximityAlert()7; 1257 5 个 参数 : 纬度 、 经 度 、 半 径 (以 米 为 单位 )、 有 效 期 限 ( 接 
近 和 警报 的 有 效 时 间 ， 时 间 过 后 将 删除 黎 报 ; -1 表示 不 会 过 期 )， 以 及 挂 起 的 意图 。 

注意 ， 如 果 Android 设备 的 屏幕 进入 睡眠 状态 ， 也 是 每 4 分 钟 检 查 一 次 接近 状态 ， 这 
样 可 以 以 延长 设备 的 电池 寿命 。 


94 项 目 一 一 创建 一 个 位 置 跟踪 应 用 程序 


现在 您 已 经 知道 了 如 何 创建 一 个 基于 位 置 的 Android 应 用 程序 ， 可 以 实际 运用 这 些 知 
识 了 。 接 下 来 将 把 本 章 中 介绍 的 技术 和 第 8 章 介 绍 的 技术 结合 起 来 ， 创 建 一 个 很 酷 、 很 实 
用 的 应 用 程序 。 所 构建 的 这 个 位 置 跟踪 应 用 程序 可 以 安 闭 到 用 户 的 Android 设备 上 。 回 用 
户 的 设备 发 送 包 合 特 殊 代码 的 SMS 消息 时 ， 用 户 的 设备 将 目 动 发 回 一 条 SMS Yi, Hp 
包含 了 设备 的 位 置 。 这 拓 位 置 跟 踩 应 用 程序 可 以 用 来 跟 踩 孩子 的 位 置 或 者 独自 生 活 的 一 位 
年 长 的 杀 属 (并 且 被 跟踪 人 可 能 不 知道 这 一 点 )。 


警告 : 在 把 这 款 应 用 程序 发 布 给 用 户 之 前 ,注意 在 一 些 国家 中 , 没有 当事人 的 
同意 就 跟踪 他 /她 的 位 置 是 非法 行为 。 如 果 在 某 个 用 户 的 手机 上 安装 了 位 置 跟 
踪 应 用 程序 ， 那 么 每 当 有 人 向 该 手机 发 送 一 条 Where are you? 的 SMS 消息 时 ， 该 
手机 就 会 向 发 送 者 发 回 其 位 置信 息 。 因 此, 如果 想 要 在 现实 生活 中 使 用 此 项 目 ， 
必须 告知 潜在 用 户 该 应 用 程序 的 功能 ， 这 样 他 们 可 以 选择 不 其 露 自己 的 位 置 。 


油 用 一 个 活动 


(1) 使 用 Eclipse 创建 一 个 新 的 Android 项 目 ， 命 名 为 LocationTracker。 
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(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 代码 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LocationTracker" 
android:versionCode-"]" 
android:versionName="1.0"> 

«uses-sdk android:minSdkVersion-"]4" /> 


<uses-permission android:name-"android.permission.RECEIVE SMS" /? 

«uses-permission android:name-"android.permission.SEND SMS" /> 

<uses-permission android:name-"android.permission.ACCESS COARSE _ 
LOCATION" /> 


«application android:icon="@drawable/icon" android:label="@string/ 
app name"> 
«activity android:name-".LocationTrackerActivity" 
android: label="@string/app name"> 
<intent-filter> 
«action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category. 
LAUNCHER" /> 
«/intent-filter» 
«/activity» 


«!-- put this here so that even if the app is not running, 
your app can be woken up when there is an incoming SMS message --> 
«receiver android:name-".SMSReceiver'"-» 
<intent-filter android:priority="100"> 
<action 
android: name="android.provider.Telephony.SMS RECEIVED"/> 
</intent-filter> 
</receiver> 
</application> 
</manifest> 


(G3) 在 项 目的 包 名 中 添加 一 个 新 的 Java 类 ,命名 为 SMSReceiver。 现 在 ， 项 目的 包 名 下 
应 该 有 一 个 名 为 SMSReceiver.java 的 Java 文件 ， 如 图 9-18 所 示 。 


e : 
4 2 LocationTracker 


4 EË sre 
4 lH netlearn2develop.LocationTracker 
J) LocationTrackerActivity.java 
> | |J] SMSReceiverjava 
à cn gen [Generated Java Files] 
HH. net.learn2develop.Location Tracker 
Bm Android 4,0 
22. assets 


— 


(4) 使 用 下 列 粗 体 显 示 的 代码 填充 SMSReceiver.java 文件 : 


package net.learn2develop.LocationTracker; 
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import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.location.Location; 

import android.location.LocationListener; 
import android.location.LocationManager; 
import android.os.Bundle; 

import android.telephony.SmsManager; 
import android.telephony.SmsMessage; 


public class SMSReceiver extends BroadcastReceiver 
{ 

LocationManager lm; 

LocationListener locationListener; 

String senderTel; 


@Override 
public void onReceive (Context context, Intent intent) 
{ 
//---get the SMS message that was received--- 
Bundle bundle = intent.getExtras(); 
SmsMessage[] msgs = null; 
String str-""; 
if (bundle !- null) 
{ 
senderTel = ""; 
//---retrieve the SMS message received--- 
Object[] pdus = (Object[]) bundle.get("pdus"); 
msgs = new SmsMessage[pdus.length]; 
for (int i-0; i«msgs.length; i++) { 
msgs[i] = SmsMessage.createFromPdu ((byte[])pdus[i]); 
if(i--0) { 
//---get the sender address/phone number--- 
senderTel = msgs[i].getOriginatingAddress(); 
} 
//---get the message body--- 
str += msgs[i] .getMessageBody () .toString() ; 


} 

if (str.startsWith("Where are you?")) { 
//---use the LocationManager class to obtain locations 
data--- 


lm = (LocationManager) 
context.getSystemService (Context.LOCATION SERVICE); 


//---request location updates--- 

locationListener = new MyLocationListener(); 

lm.requestLocationUpdates ( 
LocationManager.NETWORK PROVIDER, 
60000, 
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1000, 
locationListener) ; 


//---abort the broadcast; SMS messages wonj t be broadcasted--- 
this.abortBroadcast(); 


) 


private class MyLocationListener implements LocationListener 


{ 
(à 
public void onLocationChanged (Location loc) { 
if (loc '= null) { 
//---send a SMS containing the current location--- 
SmsManager sms — SmsManager.getDefault(); 
sms.sendTextMessage(senderTel, null, 
"http://maps.google.com/maps?q-" 十 
loc.getLatitude() + "," + 
loc.getLongitude(), null, null); 
//---stop listening for location changes--- 
lm.removeUpdates(locationListener); 
} 
} 
public void onProviderDisabled (String provider) { 
} 
public void onProviderEnabled (String provider) { 
} 
public void onStatusChanged (String provider, int status, 
Bundle extras) { 
} 
} 


} 
(5) 为 了 测试 应 用 程序 ， 首 先 把 它 部 署 到 一 个 真实 的 Android 设备 上 。 然 后 ， 使 用 另外 
-部 手机 (任意 一 部 可 以 发 送 SMS 消息 的 手机 即 可 ) 回 它 发 送 一 条 SMS 消息 : Where are you? 
(6) 在 发 送 SMS 消息 后 ， 等 待 该 Android 设备 发 回 一 条 SMS 消息 。 图 9-19 显示 了 
Android 设备 的 回复 (这 里 使 用 了 一 部 iPhone)， 其 中 包含 了 该 设备 的 位 置 。 
(7) 大 多 数 智能 手机 能 够 识别 SMS YALA URL 数据 。 因 此 ， 如 果 单 击 SMS 消 县 中 
的 URL， 可 以 在 Google Maps 中 看 到 这 个 位 置 ， 如 图 9-20 Pras. 
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图 9-19 


示例 说 明 

这 个 项 目 在 一 个 完整 的 应 用 程序 中 结合 运用 了 本 章 学 习 的 概念 和 在 第 8 章 中 学 习 的 关 
于 SMS 消息 传递 的 知识 。 在 安装 了 这 个 应 用 程序 后 ， 它 会 侦 听 传 入 的 SMS IB BIET US 
文本 “Where are you?”。 然 后 它 会 拦截 这 些 SMS 消息 ， 这 样 用 户 就 不 会 在 Android 设备 上 
的 Messaging 应 用 程序 中 看 到 这 些 消 奶 。 

当 收 到 SMS 消 垦 后， 首先 提取 发 送 者 的 电话 号 个， 这 样 以 后 就 可 以 同 这 个 号 人 码 发 送 
包含 设备 位 置 的 回复 : 


//---retrieve the SMS message received--- 
senderTel - ""; 


//---retrieve the SMS message received--- 
Object[] pdus = (Object[]) bundle.get ("pdus"); 
msgs = new SmsMessage[pdus.length|; 
for (int 1-0; i<msgs.length; i++) { 
msgs[i] = SmsMessage.createFromPdu ( (byte[])pdus[i]); 
if (i--0) { 
//---get the sender address/phone number--- 
senderTel = msgs[i].getOriginatingAddress(); 
} 
//---get the message body--- 
str += msgs[i].getMessageBody().toString(); 
} 


然后 观察 SMS 消息 的 内 容 。 如 果 它 以 句子 Where are you? Ff 3, wt {iF LocationManager 
类 请 求 位 置 更 新 : 


if (str.startsWith("Where are you?")) | 
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//---use the LocationManager class to obtain locations data--- 
lm = (LocationManager) 
context.getSystemService(Context.LOCATION SERVICE); 


//---request location updates--- 
locationListener = new MyLocationListener(); 
lm.requestLocationUpdates ( 
LocationManager.NETWORK PROVIDER, 
60000, 
1000, 
locationListener); 


this.abortBroadcast(); 
] 


注意 ， 这 个 示例 中 使 用 了 网 络 位 置 服务 提供 商 来 获取 位 置信 息 ， 因 为 它 不 再 要 在 一 个 
空旷 的 位 置 (这 是 GPS 位 置 服务 服务 提供 商 的 要 求 )。 但 是 ， 使 用 网 络 位 置 服务 提供 商 需 要 
设备 连接 到 Ptermnet， 所 以 如 果 设 备 没 有 网 络 连接 ， 应 用 程序 将 无 法 工作 。 

获得 位 置 后 , 使 用 一 个 指向 Google Maps 的 URL 发 回 一 条 包含 设备 位 置 的 SMS 消息 : 

public void onLocationChanged (Location loc) { 
if (loc !- null) { 
//---send a SMS containing the current location--- 
smsManager sms = SmsManager.getDefault(); 
sms.sendTextMessage(senderTel, null, 
"http: //maps.google.com/maps?q="+loc.getLatitude ()+", "+ 
loc.getLongitude(), null, null); 


//---stop listening for location changes--- 
lm.removeUpdates(locationListener); 


) 


发 送 SMS 消息 后 ， 立 即 删除 位 置 更 新 应 用 程序 ， 这 样 就 不 会 继续 侦 听 位 置 变化 。 

注意 , 代码 中 分 别 为 TequestLocationUpdatesO) 方 法 的 minTime 和 minDistance 参数 使 用 
了 60 000 毫秒 和 1000 米 。 回 忆 一 下 ， 本 章 前 面 为 这 两 个 参数 使 用 的 值 是 0， 这 是 为 了 能 
够 不 断 地 收 到 位 置 变化 的 信息 。 但 是 ， 在 这 个 项 目 中 不 应 该 这 么 做 ， 人 否则 应 用 程序 会 不 断 
地 一 次 性 向 SMS 消息 发 送 者 发 回 多 条 SMS 消息 。 这 是 因为 当 停 止 侦 听 位 置 更 新 时 ， 
Location Manager 将 会 调用 几 次 onLocationChanged0) 方 法 ， 报 告 设 备 最 小 的 位 置 变化 ， 从 
而 导致 发 送 多 条 SMS 消 县 。 在 实际 的 测试 中 ，SMS 消息 的 数量 在 10 条 到 60 条 之 间 。 因 
此 ， 应 该 将 minTime 和 minDistance 参数 设 为 更 加 合理 的 值 ， 这 样 Location Manager 就 不 
能 重复 地 触发 onLocationChanged0 方 法 。 
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9.5 ”本章 小 结 


本 章 对 在 Android 应 用 程序 中 用 于 显示 Google Maps 的 MapView 对 象 进行 了 大 致 的 了 
解 。 我 们 学 习 了 操作 地 图 的 不 同方 式 ， 还 学 习 了 如 何 使 用 不 同 的 网 络 服务 提供 商 来 获取 地 
理 位 置 数据 : 采用 GPS、Cell-ID 和 Wi-Fi 三 角 测 量 法 。 最 后 ， 学 习 了 如 何 构建 一 个 使 用 
SMS 消息 传递 跟踪 用 户 位 置 的 位 置 跟踪 应 用 程序 。 


1. 如 果 您 在 Android MHIE HRA T Google Maps API， 但 在 应 用 程序 加 载 时 并 没 
有 显示 出 地 图 ， 那 么 最 可 能 的 原因 有 哇 些 ? 

2. 地 理 编码 和 反问 地 理 编码 有 何 区 别 ? 

3. 说 出 可 用 于 获得 位 置 数据 的 两 个 位 置 服务 提供 商 。 

4. 监控 一 个 位 置 的 方法 是 什么 ? 

练习 答案 参见 附录 C. 


本 章 主 要 内 容 
t 题 关键 概念 
<com.google.android.maps.MapView 

android: id="@+id/mapView" 
android: layout width-"fill parent" 

显示 MapView android:layout height-"fill parent" 
android:enabled-"true" 
android:clickable-"true" 
android:apiKey-"YOUR MAPS API KEY" /» 

| «uses-library android:name="com.google. 

引用 Map He android.maps" /» 

显示 缩放 控件 mapView.setBuiltiInZoomControls (true); 


a mc.zoomIn(); 
以 编程 方式 对 地 图 进行 缩放 | ”mc . zoomout () ; 
fees IMapView.setSatellite (true); 
改变 视图 mMapView.setTraffic (true); 
mc = mapView.getController(); 
String coordinates[] = ["1.352566007", 


"103.78921587"}; 
double lat = Double.parseDouble (coordinates [0]); 
动画 显示 到 一 个 特定 位 置 double ing = Double.parseDouble(coordinates[1]); 


p = new GeoPoint( 
(int) (lat * 1E6), 
(int) (lng * 1E6)); 
mc.animateTo (p); 


实现 一 个 Overlay 类 并 重 写 draw0 方 法 
GeoPoint p = mapView.getProjection() .fromPixels ( 


获取 在 地 图 上 触摸 的 位 置 (int) event.getX(), 
(int) event.getY()); 


添加 标记 
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( 续 表 ) 
E E 关键 概念 
地 理 编码 和 反 向 地 理 编码 | 使 用 Geocoder X 


private LocationManager lm; 


I ETT 
lm = (LocationManager) 
getSystemService(Context.LOCATION SE 
RVICE); 
locationListener = new My Location 
Listener(); 
lm.requestLocationUpdates ( 
LocationManager.GPS PROVIDER, 
0, 
0, 
locationListener); 
PT 


private class MyLocationListener implements 
"" | LocationListener 
获取 位 置 数据 


public void onLocationChanged (Location loc) { 
if (loc != null) { 
} 


public void onProviderDisabled (String 
provider) { 


public void onProviderEnabled (String 
provider) { 


} 


public void onStatusChanged (String 


provider, int status,Bundle extras) { 


} 
} 


lm.addProximityAlert (37.422006, -122.084095,5,-1, 
pendingIntent); 


监控 一 个 位 置 
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本 章 将 介绍 以 下 内 容 : 

e 如 何 利 用 HTTP 连接 Web. 

e 如 何 使 用 XML Web 服务 。 

e 如 何 使 用 JSON Web 服务 。 

e 如 何 与 套 接 字 服务 器 建立 连接 。 


在 第 8 章 ， 已 经 学 习 了 应 用 程序 如 何 使 用 SMS 消息 传递 和 邮件 来 与 外 界 环境 通信 。 
另 一 种 与 外 界 环 境 进行 通信 的 方式 是 通过 Android 设备 可 用 的 无 线 网 络 。 因 此 ， 在 本 章 中 
将 学 习 如 何 使 用 HTTP 协议 与 Web 服务 器 通信 ， 以 下 载 文本 和 二 进 制 数据 ， 也 将 学 习 如 何 
分 析 XML 文件 来 提取 XML 文档 的 相关 部 分 一 一 这 是 一 种 在 访问 Web 服务 时 非常 有 用 的 
技术 。 除 了 XML Web 服务 以 外 ， 本 章 将 涵闸 JSON(JavaScript Object Notation, JavaScript 
MAGS), AE XML 的 一 种 轻 量 级 奉 代 形式 。 本 章 中 将 使 用 Android SDK 提供 的 类 来 操 
作 JSON 内 容 。 

最 后 ， 本 章 还 将 演示 如 何 编写 一 个 使 用 TCP 套 接 字 连接 服务 器 的 Android 应 用 程序 。 
利用 套 接 字 编程 ， 可 以 编写 复杂 但 有 趣 的 网 络 应 用 程序 。 


10.1 通过 HTTP 使 用 Web 服务 


与 外 界 进行 通信 的 一 种 常用 方法 是 通过 HTTP。 大 多 数 人 对 HTTP 并 不 会 感到 陌生 ， 
它 是 推动 Web 走向 成 功 的 一 种 协议 。 通 过 使 用 HTTP 协议 ， 可 以 执行 各 种 广泛 的 任务 ， 比 
如 从 Web 服务 嚣 下载 网 页 、 下 载 二 进 制 数据 等 。 

下 面 的 “ 试 一 试 ” 创 建 了 一 个 Android 项 目 ， 从 而 可 以 利用 HTTP 协议 连接 到 Web 来 
下 载 各 种 内 容 。 


wa 为 HTTP 连接 创建 基础 项 目 


TCE Y ff Networking.zip ATM Wrox.com FE 
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(1) 利用 Eclipse 创建 一 个 新 的 Android 项 目 ， 将 其 命名 为 Networking。 
(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 语句 。 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Networking" 
android:versionCode="1" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android: name="android. permission. INTERNET" /> 


<application 

android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

<activity 
android: label="@string/app name" 
android:name-".NetworkingActivity" > 
«intent-filter > 

<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
«/intent-filter» 
<factivity> 
</application> 


</manifest> 


(3) 把 下 列 包 导入 到 NetworkingActivity.java 文件 中 。 


package net.learn2develop.Networking; 


import android.app.Activity; 
import android.os.Bundle; 
import java.io.IOException; 
import java.io.InputStream; 
import java.net.HttpURLConnection; 
import java.net.URL; 
import java.net.URLConnection; 
import android.util.Log; 
public class NetworkingActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView (R.layout.main) ; 


) 


(4) 在 NetworkingActivity.java 文件 中 定义 OpenHttpConnection() 77 1Z; . 
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public class NetworkingActivity extends Activity I 
private InputStream OpenHttpConnection(String urlString) throws 
IOException 
{ 
InputStream in = null; 
int response = -1; 


URL url = new URL(urlString) ; 
URLConnection conn = url.openConnection () ; 


if (! (conn instanceof HttpURLConnection) ) 
throw new IOException ("Not an HTTP connection"); 
try { 
HttpURLConnection httpConn = (HttpURLConnection) conn; 
httpConn.setAllowUseriInteraction (false); 
httpConn.setInstanceFollowRedirects (true); 
httpConn.setRequestMethod ("GET") ; 
httpConn.connect (); 
response = httpConn.getResponseCode(); 
if (response == HttpURLConnection.HTTP OK) { 
in = httpConn.getInputStream(); 


} 
} 
catch (Exception ex) 
{ 
Log.d("Networking", ex.getLocalizedMessage()); 
throw new IOException("Error connecting"); 
} 


return in; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView(R.layout.main); 


} 

示例 说 明 

因为 是 使 用 HTTP 协议 连接 到 Web， 应 用 程序 需要 INTERNET 许可 ， 因 此 ， 首 先 将 许 
可 协议 添加 到 AndroidManifest.xml 文件 中 。 

然后 定义 OpenHttpConnection 方法 ， 它 以 一 个 URL 字符 串 作 为 参数 ， 并 返回 一 个 
InputStream 对 象 。 为 下 载 数 据 ， 通 过 使 用 一 个 InputStream 对 象 从 流 对 象 读 取 数 据 。 在 这 
个 方法 中 , 可 以 利用 HttpURLConnection 对 象 建立 与 远程 URL 的 HTTP 连接 。 可 以 设置 连 
接 的 各 种 特性 ， 比 如 请 求 方法 等 等 。 


HttpURLConnection httpConn = (HttpURLConnection) conn; 
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httpConn.setAllowUserInteraction(false); 
httpConn.setInstanceFollowRedirects (true); 
httpConn.setRequestMethod ("GET") ; 


在 尝试 建立 与 服务 器 的 连接 之 后 , 会 返回 HTTP 响应 代码 。 如 果 连 接 成 功 建立 (响应 代 
人 码 为 HTTP_OK)， 就 可 以 继续 从 连接 中 得 到 一 个 InputStream 对 象 : 
httpConn. connect () ; 
response = httpConn.getResponseCode(); 
if (response == HttpURLConnection.HTTP OK) { 


in = httpConn.getInputStream(); 
} 


接 下 来 可 以 使 用 InputStreams 对 象 开 始 从 服务 器 下 载 数 据 。 
10.1.1 下 载 二 进 制 数 据 


需要 执行 的 一 件 常见 任务 是 从 Web 下 载 二 进 制 数据 。 比 如 ， 可 能 想 要 从 服务 器 下 载 
张 图 片 ， 以 便 可 以 在 应 用 程序 中 显示 。 下 面 的 “ 试 一 试 ”展示 了 下 载 二 进 制 数据 的 方法 。 


下 载 二 进 制 数据 
(1) 利用 之 前 创建 的 相同 项 目 , 在 main.xml 文件 中 , 将 默认 的 TextView 替换 为 下 列 粗 
体 显 示 的 语句 。 


<?xml version-"1.0" encoding="utf-8"?> 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«ImageView 
android: id="@+id/img" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android: layout gravity="center" /> 


</LinearLayout> 

(2) 在 NetworkingActivity java 文件 中 添加 下 列 粗 体 显 示 的 语句 。 
import android.widget.ImageView; 

import android.graphics.Bitmap; 

import android.graphics.BitmapFactory; 


import android.os.AsyncTask; 


public class NetworkingActivity extends Activity { 
ImageView img; 


private InputStream OpenHttpConnection (String urlString) throws IOException 
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InputStream in = null; 
int response = -1; 


URL url = new URL(urlString); 
URLConnection conn = url.openConnection(); 


if (! (conn instanceof HttpURLConnection) ) 
throw new IOException("Not an HTTP connection"); 
tryí 
HttpURLConnection httpConn - (HttpURLConnection) conn; 
httpConn.setAllowUserInteraction(false); 
httpConn.setInstanceFollowRedirects (true); 
httpConn.setRequestMethod ("GET") ; 
httpConn.connect (); 
response = httpConn.getResponseCode (); 
if (response == HttpURLConnection.HTTP OK) { 
in = httpConn.getInputStream(); 


} 

catch (Exception ex) 

Í 
Log.d("Networking", ex.getLocalizedMessage()); 
throw new IOException("Error connecting"); 

} 


return in; 


private Bitmap DownloadImage (String URL) 
{ 
Bitmap bitmap = null; 
InputStream in = null; 
try { 
in = OpenHttpConnection (URL) ; 
bitmap = BitmapFactory.decodeStream (in) ; 
in.close(); 
} catch (IOException el) { 
Log.d("NetworkingActivity", el.getLocalizedMessage()); 
} 
return bitmap; 


private class DownloadlImageTask extends AsyncTask<String, Void, Bitmap>{ 
protected Bitmap doInBackground(String... urls) { 
return DownloadImage (urls[0]); 


protected void onPostExecute (Bitmap result) { 
ImageView img — (ImageView) findViewById(R.id.img); 
Img.setlImageBitmap (result); 
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} 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView(R.layout.main); 
new DownloadImageTask().execute( 
"http: //www.mayoff.com/5-01cablecarDCP01934.Jjpg"); 


) 
(3) {x F11 键 在 Android FRU as EVADE, ÉD 10-1 显示 从 Web 下 载 并 在 
ImageView 中 展示 的 一 幅 图 片 。 


示例 说 明 


DownLoadImasge0 方 法 接受 要 下 载 的 图 片 的 URL 作为 参数 ， 并 使 用 之 前 定义 的 
OpenHttpConnection0) 方 法 来 打开 与 服务 器 的 连接 。 通 过 使 用 BitmapFactory 类 的 
decodeStream0 〇 方法 和 连接 返回 的 InputStream 对 象 下载 数 据 并 把 数据 解 公 为 Bitmap 对 象 。 
DownloadImage0 方 法 返回 一 个 Bitmap 对 象 。 

为 了 下 载 一 张 图 片 并 在 活动 中 显示 它 ， 可 以 调用 DownloadImage0 方 法 ， 但 是 ， 从 
Android3.0 版 本 开始 ， 不 能 直接 在 UI 线程 中 直接 执行 同步 操作 。 如 果 尝 试 在 onCreate(77 
式 中 直接 调用 DowmloadImage0 方 法 (如 以 下 代码 段 所 示 )， 那 么 当 应 用 程序 运行 在 
Android3.0 及 于 局 版 本 的 设备 上 时 会 骨 演 。 

/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) | 
super .onCreate (savedinstanceState); 
setContentView(R.layout.main); 
//---download an image--- 
//---code will not run in Android 3.0 and beyond--- 
Bitmap bitmap - 
DownloadImage ("http: //www.mayoff.com/5-OlcablecarDCP01934. 
jpg"); 
img = (ImageView) findViewById(R.id.img); 
img.setImageBitmap (bitmap); 
} 


因为 DownloadImage0 方 法 是 同步 的 一 一 这 意味 着 ， 在 图 片 下 载 完 之 前 不 会 返回 控制 权 
一 一 所 以 直接 调用 它 会 导致 活动 UI 冻结， 这 在 Android 3.0 及 更 高 版 本 上 是 不 允许 的 ， 必须 使 
用 AsyncTask 类 封装 所 有 同步 代码 。 使 用 AsyncTask 允许 在 单独 的 线程 中 执行 后 台 任务 ,然后 
在 UI 线 程 中 返回 结果 。 这 样 的 话 ， 不 需要 处 理 复杂 的 线程 问题 就 可 以 执行 后 台 操 作 。 
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= an 中 


Networking 


图 10-1 


如 要 异步 访问 DownloadImage0 方 法 ， 需 要 将 代码 段 封 装 在 AsyncTask 类 的 子 类 中 ， 
如 下 所 示 : 
private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> { 

protected Bitmap dolInBackground (String... urls) { 
return DownloadImage (urls[0]); 

] 

protected void onPostExecute(Bitmap result) { 
ImageView img = (ImageView) findViewById(R.id.img); 
img.setlImageBitmap (result); 


} 

这 里 基本 上 就 是 定义 一 个 扩展 了 AsyncTask 类 的 类 (DownloadImageTask)。 在 本 例 中 ， 
DownloadImageTask 类 中 有 两 个 方法 : doInBackground0 和 onPostExcute(). 

把 所 有 需要 异步 运行 的 代码 都 置 于 doInBackGround0 方 法 中 。 当 任务 完成 后 ， 通 过 
onPostExcute0 方 法 传 回 结 果 。 在 本 例 中 ， 利 用 ImageView 展示 下 载 的 图 片 。 

在 UI 线程 中 运行 同步 操作 

具体 来 说 ， 如 果 将 AndroidManifest.xml 文件 中 android:minSdkVersion 属性 的 值 设置 为 
小 于 或 等 于 9， 那 么 在 Android 3.0 或 更 高 版 本 的 设备 上 运行 应 用 程序 时 ， 同 步 代 码 仍然 会 
在 UI 线程 中 运行 (尽管 不 推荐 )。 但 是 ， 如 果 将 android:minSdkVersion 属性 的 值 设置 为 大 于 
或 等 于 10， 同 步 代 码 不 会 在 UI 线程 中 运行 。 


注意 : 第 11 章 会 详细 讨论 AsyncTask 类 。 
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为 调用 DownloadImageTask 类 ， 创 建 它 的 一 个 实例 并 调用 它 的 execute0 方 法 ， 传 入 要 
下 载 的 图 片 的 URL. 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 
new DownloadImageTask () .execute ( 
"http: //www.mayoff.com/5-OlcablecarDCP01934. jpg") ; 


} 
如 果 想 要 异步 下 载 一 系列 图 片 ， 可 以 按 如 下 方法 修改 DownloadImageTask 25. 


import android.widget.Toast; 


private class DownloadlImageTask extends AsyncTask 
«String, Bitmap, Long> | 
//---takes in a list of image URLs in String type--- 
protected Long doInBackground(String... urls) { 
long imagesCount - 0; 
for (int i = 0; i < urls.length; i++) { 
//---download the image--- 
Bitmap imageDownloaded = DownloadImage (urls[1i]); 
if (imageDownloaded != null) { 
//---increment the image count--- 
imagesCount++; 
try { 
//---insert a delay of 3 seconds--- 
Thread.sleep (3000) ; 
} catch (InterruptedException e) { 
e.printStackTrace(); 
] 
//---return the image downloaded--- 
publishProgress (imageDownloaded) ; 


} 


//---return the total images downloaded count--- 


return imagesCount; 


//---display the image downloaded--- 
protected void onProgressUpdate(Bitmap... bitmap) { 
img.setlImageBitmap (bitmap[0]) ; 


//---when all the images have been downloaded--- 
protected void onPostExecute(Long imagesDownloaded) { 
Toast.makeText(getBaseContext(), 
"Total " + imagesDownloaded + " images downloaded" , 
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Toast.LENGTH LONG) .show() ; 
} 
注意 在 本 例 中 ，DownloadImageTask 类 有 男 一 个 方法 : onProgressUpdate0 。 因 为 要 在 
AsyncTask 类 内 部 执行 的 任务 可 能 耗 时 很 长 ， 所 以 调用 publishProgess0 方 法 来 更 新 操作 的 
进度 。 这 会 触发 onProgressUpdate0 方 法 ， 在 本 例 中 它 会 显示 要 下 载 的 图 片 。onProgress- 
Update0 方 法 在 UI 线程 中 执行 ， 因 此， 使 用 从 服务 器 下 载 的 位 图 更 新 ImageView 是 线程 安 
全 的 。 
为 了 在 后 台 异 步 下 载 一 系列 图 片 ， 需 要 创建 一 个 BackgroundTask 类 的 实例 并 访问 
它 的 execute0 方 法 ， 如 下 所 示 : 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


/* new DownloadImageTask () .execute ( 
"http: //www.mayoff.com/5-OlcablecarDCP01934. jpg") ; 
*/ 


img = (ImageView) findViewById(R.id.img); 
new DownloadImageTask () .execute ( 

"http: //www.mayoff.com/5-OlcablecarDCP01934.jpg", 

"http: //www.hartiesinfo.net/greybox/Cable Car 
Hartbeespoort.jpg", 

"http: //mcmanuslab.ucsf.edu/sites/default/files/ 
imagepicker/m/mmcmanus/ 
CaliforniaSanFranciscoPaintedLadiesHz.jpg", 

"http://www. fantom-xp.com/wallpapers/63/San Francisco 
,- Sunset.jpg", 

"http://travel.roro44.com/europe/france/ 

Paris France.jpg", 

"http: //wwp.greenwichmeantime.com/time-zone/usa/nevada 
/las-vegas/hotel/the-strip/paris-las-vegas/paris- 
las-vegas-hotel.Jjpg", 

"http://designheaven.files.wordpress.com/2010/04/ 
eiffel tower paris france.jpg"); 

} 
当 运 行 上 述 代 码 段 时 ， 图 片 在 后 人 台 下 载 并 且 以 每 3 秒 一 次 的 频率 显示 。 当 下 载 完 最 后 
从 模拟 器 指向 localhost 
当 使 用 Android 模拟 器 时 , 可 能 经 常 需 要 利用 localhost 访问 本 地 Web 服务 器 上 存储 的 
数据 。 例 如 ， 你 目 己 的 Web 服务 很 可 能 在 开发 过 程 中 驻 留 在 本 地 计算 机 上 ， 而 你 想 要 在 编 
写 Android 应 用 程序 所 用 的 相同 开发 机 器 上 测试 它们 。 在 这 种 情况 下 ， 应 该 利用 特殊 的 IP 
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地 址 10.0.2.2( 而 不 是 127.0.0.1) 来 指向 主机 的 回环 接口 。 从 Android 模拟 器 的 角度 来 看 ， 
localhost(127.0.0.1) 指 的 是 它 本 身 的 回环 接口 。 


10.1.2 下 载 文 本 内 容 


除了 下 载 二 进 制 数 据 以 外 ， 还 可 以 下 载 纯 文本 内 容 。 例 如 ， 想 要 访问 一 个 返回 随机 5 
文字 符 串 的 Web 服务 。 下 面 的 “ 试 一 试 ” 展 示 如 何在 应 用 程序 中 从 Web 服务 下 载 一 个 字 
符 串 。 


下 载 纯 文 本 内 容 
(1) 利用 之 前 创建 相同 项 目 , 在 NetworkingActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句。 


import java.io.InputStreamReader; 


private String DownloadText(String URL) 
{ 
int BUFFER SIZE = 2000; 
InputStream in = null; 
try { 
in = OpenHttpConnection (URL) ; 
} catch (IOException e) { 
Log.d("Networking", e.getLocalizedMessage()); 
return "": 


) 


InputStreamReader isr = new InputStreamReader (in); 
int charRead; 
String str = ""; 
char[] inputBuffer = new char[BUFFER SIZE]; 
try { 
while ((charRead = isr.read(inputBuffer))>0) { 
//---convert the chars to a String--- 
String readString - 
String.copyValueOf (inputBuffer, 0, charRead) ; 
str += readString; 
inputBuffer = new char[BUFFER SIZE]; 
} 
in.close(); 
} catch (IOException e) { 
Log.d("Networking", e.getLocalizedMessage()); 
return "": 
} 
return str; 


} 
private class DownloadTextTask extends AsyncTask<String, Void, String> 


protected String doInBackground (String... urls) { 
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return DownloadText(urls[0]); 


@Override 

protected void onPostExecute (String result) { 
Toast.makeText (getBaseContext(), result, Toast.LENGTH LONG). 
show (); 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


//---download text--- 
new DownloadTexttTask () .execute ( 
"http: //iheartquotes.com/api/v1/random?max characters-256& 
max lines=10") ; 


(2) 44% F11 键 在 Android RWM AE IAD AE. K 10-2 展示 了 利用 Toast 类 下 载 和 
展示 的 随机 引文 字符 串 。 


® 9:37 


<?xml version='1.0" 

encoding- UTF-8'?» <?xml-stylesheet 
type- text/xsl' href="http://appleinsider. 
com.feedsportal.com/xsl/eng/rss.xsl?» 
«rss xmlIns:itunes-" http://www.itunes. 
com/dtds/podcast- 1.0.dtd" xmins: 
dc-"http://purl.org/dc/elements/1.1/" 
xmlns:taxo- "http://purl.org/rss/1.0/ 
modules/taxonomy/" xmlns:rdf-"http:// 
www.w3.org/1999/02/22-rdf-syntax-ns?t" 
version-"2.0"»«channel»«title» AppleInsid 
er«/title» «link»http://www.appleinsider. 
com/</link><description>Applelnsider 
has been the leading source of insider 
news and rumors on Apple Computer 
since 1997.</description><language>en- 
us</language><pubDate>Mon, 21 Nov 
2011 13:30:02 GMT</ 
pubDate><lastBuild Date>Mon, 21 Nov 


图 10-2 
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示例 说 明 

DownloadText() 方 法 接受 要 下 载 的 文本 文件 的 URL 作为 参数 ， 人 返回 所 下 载 文本 文 
件 的 字符 串 。 它 基本 上 就 是 打开 一 个 与 服务 器 的 HTTP 连接 ， 然 后 使 用 一 个 
InputStreamReader 对 象 读 取 流 中 的 每 个 字符 , 并 将 其 保存 在 一 个 String 对 象 中 。 正 如 前 


一 节 所 示 ， 必 须 创 建 一 个 AsyncTask 类 的 子 类 才能 异步 调用 DownloadTextO 方 法 。 
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到 现在 为 止 , 己 经 介绍 如 何 从 Web 下 载 图 像 和 文本 。 前 一 节 介 绍 如 何 从 服务 器 下 载 一 
些 纯 文 本 .第 见 的 一 种 情况 是 需要 下 载 XML 文件 并 解析 其 内 容 (使 用 Web 服务 是 一 个 很 好 
的 例子 )。 因 此 ， 本 节 将 介绍 如 何 使 用 HTTP GET 方法 连接 Web 服务 。 一 旦 Web 服务 返回 
XML 格式 的 结果 ， 就 提取 相关 的 部 分 并 使 用 Toast 类 显示 它 的 内 容 。 

本 例 中 , EH T http://services.aonaware.com/DictService/DictService.asmx?o0p=Define 提 
供 的 Web 方法 。 这 个 Web 方法 来 自 一 个 词典 Web 服务 ， 它 会 返回 给 定 词 的 定义 。 

该 Web 方法 接受 如 下 格式 的 请 求 。 


GET /DictService/DictService.asmx/Define?word=string HTTP/1.1 
Host: services.aonaware.com 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset-utf-8 

Content-Length: length 


它 以 下 列 格式 返回 啊 应 。 


<?xml version-"1.0" encoding-"utfí-8"?» 
«WordDefinition xmlns-"http://services.aonaware.com/webservices/"» 
<Word>string</Word> 
<Definitions> 
<Definition> 
<Word>string</Word> 
<Dictionary> 
<Id>string</Id> 
<Name>string</Name> 
</Dictionary> 
<WordDefinition>string</WordDefinition> 
</Definition> 
<Definition> 
<Word>string</Word> 
<Dictionary> 
<Id>string</Id> 
<Name>string</Name> 
</Dictionary> 
<WordDefinition>string</WordDefinition> 
</Definition> 
</Definitions> 
</WordDefinition> 
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因此 ,要 获取 一 个 词 的 定义 必须 先 建立 一 个 连接 到 该 Web 方法 的 HTTP 连接 ,然后 
解析 返回 的 XML 结果。 下 面 的 “ 试 一 试 ”展示 了 具体 做 法 。 


使 用 Web 服务 
(1) 利用 之 前 创建 的 相同 项 目 ， 在 NetworkingActivity.java 文件 中 添加 下 列 粗 体 显示 的 


语句 。 
import 
import 
import 


import 
import 
import 
import 


javax.xml.parsers .DocumentBuilder; 


javax.xml.parsers .DocumentBuilderFactory ; 


javax.xml.parsers.ParserConfigurationException; 


org.w3c 
org.w3c 
org.w3c 
org.w3c 


. dom . Document ; 
. dom. Element; 
. dom. Node; 

.dom.NodeList; 


private String WordDefinition(String word) { 


InputStream in = null; 


String strDefinition = ""; 


try { 


in = OpenHttpConnection ( 
"http: //services.aonaware.com/DictService/DictService.asmx/Define?word= 
" + word); 


Document doc = null; 


DocumentBuilderFactory dbf = 


DocumentBuilderFactory.newInstance(); 


DocumentBuilder db; 


try 1 


db = dbf.newDocumentBuilder(); 
doc = db.parse(in); 


} catch (ParserConfigurationException e) { 


// TODO Auto-generated catch block 
e.printStackTrace(); 


} catch (Exception e) { 


} 


// TODO Auto-generated catch block 
e.printStackTrace(); 


doc.getDocumentElement().normalize(); 


//---retrieve all the «Definition» elements--- 
NodeList definitionElements - 


doc.getElementsByTagName ("Definition"); 


//---iterate through each «Definition» elements--- 
for (int i = 0; i < definitionElements.getLength(); i++) { 


Node itemNode = definitionElements.item(1); 

if (itemNode.getNodeType() -- Node.ELEMENT NODE) 

{ 
//---convert the Definition node into an Element--- 
Element definitionElement = (Element) itemNode; 
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//---get all the <WordDefinition> elements under 

// the «Definition» element--- 

NodeList wordDefinitionElements = 
(definitionElement).getElementsByTagName ( 
"WordDefinition"); 


strDefinition - ""; 
//---iterate through each «WordDefinition» elements--- 
for (int j = 0;jJ<wordDefinitionElements.getLength () ;j3++) { 
//---convert a <WordDefinition> node into an 
Element--- 
Element wordDefinitionElement = 
(Element) wordDefinitionElements.item(Jj); 


//---get all the child nodes under the 
// <WordDefinition> element--- 
NodeList textNodes = 
( (Node) wordDefinitionElement) .getChildNodes () ; 


strDefinition += 
( (Node) textNodes . item (0) ) .getNodeValue ()+".\n"; 


) 
} catch (IOException el) { 

Log.d("NetworkingActivity", el.getLocalizedMessage()); 
} 
//---return the definitions of the word--- 


return strDefinition; 


private class AccessWebServiceTask extends AsyncTask<String, Void, 
String> { 
protected String doInBackground(String... urls) { 
return WordDefinition(urls[0]); 


protected void onPostExecute(String result) { 
Toast.makeText(getBaseContext(),result,Toast.LENGTH LONG).show(); 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedinstanceState) ; 
setContentView(R.layout.main); 
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//---access a Web Service using GET--- 
new AccessWebServiceTask () .execute ("apple"); 


(2) 4% F11 BEE Android 模拟 器 中 调试 应 用 程序 。 图 10-3 展示 了 Web 服务 调用 被 解 
析 的 结果 ， 然 后 利用 Toast 类 进行 显示 。 


CHN 


== 


V 


Apple 

(Heb. tappuah, meaning "fragrance"). 
Probably the apricot or 

quince is intended by the word, as 
Palestine was too hot for the 

growth of apples proper. It is 
enumerated among the most 

valuable trees of Palestine (Joel 1:12), 
and frequently referred 

to in Canticles, and noted for its beauty 
(2:3, 5; 8:5). There 

is nothing to show that it was the "tree of 
the knowledge of 

good and evil." Dr. Tristram has 
suggested that the apricot has 

better claims than anv other fruit-tree to 


APPLE 


«language» A revision of {APL} for the 
{Iliac IV}. 


(1995-04-28) 


图 10-3 
示例 说 明 
WordDefinition0 方 法 首先 建立 一 个 与 Web 服务 的 HTTP 连接 ， 需 要 传 入 感 兴趣 的 词 : 


in = OpenHttpConnection ( 
"http: //services.aonaware.com/DictService/DictService.asmx/Define 


?word-" + word); 


然后 利用 DocumentBuliderFactory 和 DocumentBulider 对 象 从 一 个 XML( 从 Web 服务 
返回 的 XML 结果 ) 文 件 中 获取 一 个 Document (DOM) 对 象 。 


Document doc = null; 
DocumentBuilderFactory dbf = 
DocumentBuilderFactory.newInstance(); 
DocumentBuilder db; 
try 1 
db = dbf.newDocumentBuilder(); 
doc = db.parse(in); 
} catch (ParserConfigurationException e) { 
// TODO Auto-generated catch block 
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e.printStackTrace(); 

} catch (Exception e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

} 


doc.getDocumentElement () .normalize(); 


日 获取 Document 对 象 ， 可 以 在 <Definition> 标 签 中 发 现 所 有 元 素 。 


//---retrieve all the «Definition» elements--- 
NodeList definitionElements - 
doc.getElementsByTagName ("Definition"); 


图 10-4 展示 了 从 Web 服务 返回 的 XML 文档 的 结构 。 


*«WordDeflnition xmlns:xsis"http://www.w3.0rg/2001/ 
XMLSchema-instance" xmlns:xsd-"http://www.w3.org/2801/ 
XML5chema" xmlnss"http://services.aonaware,com/ 
webservices/"> 

tWord>apple< /Word> 
¥<Definitions> 
¥<Definition> 
<Word>apple</Word> 
+ <Dictionary>.</Dictionary> 
+ <WordDefinition>..< /WordDefinition> 
</Definition> 


¥<Definition> 


«<Word>apple< /Word> 
> <Dictionary>.</Dictionary> 
| <WordDefinition>..</WordDefinition> 
</Definition> 
» <Definition>..</Definition> 
+ <Definition>..</Definition> 
+ <Definition>..</Definition> 
</Definitions> 
</WordDefinition> 


图 10-4 
因为 词 的 定义 包含 在 <WordDefinition> 元 素 中 ， 接 下 来 可 以 提取 所 有 和 定义 。 


//---iterate through each «Definition» elements--- 
for (int i = 0; i < definitionElements.getLength(); i++) { 
Node itemNode = definitionElements.item(íi); 


if (itemNode.getNodeType() == Node.ELEMENT NODE) 

{ 
//---convert the Definition node into an Element--- 
Element definitionklement = (Element) itemNode; 


//---get all the «WordDefinition» elements under 

// the «Definition» element--- 

NodeList wordDefinitionElements = 
(definitionElement).getElementsByTagName ( 
"WordDefinition"); 


strDefinition - ""; 

//---iterate through each «WordDefinition» elements--- 

for (int j = 0; j < wordDefinitionElements.getLength(); j++) { 
//---convert a «WordDefinition» node into an Element--- 
Element wordDefinitionElement = 


(Element) wordDefinitionElements.item(íj); 
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//---get all the child nodes under the 
// «WordDefinition» element--- 
NodeList textNodes - 
((Node) wordDefinitionElement).getChildNodes(); 


strDefinition += 
((Node) textNodes.item(0)).getNodeValue() + ". \n"; 
} } 
} 
ER AN (CAS Be li 71 Pr A «Definition? 76 K, fr HK 4 A <WordDefinition> If] T 76 3& 。 
<WordDefinition> 元 素 的 文本 内 容 包 含 词 的 定义 ， 词 的 定义 会 连接 起 来 ， 并 由 WordDe- 
finition0 方 法 返回 。 


//---return the definitions of the word--- 
return strDefinition; 


与 往常 一 样 , 需要 创建 AsyncTask 类 的 一 个 子 类 来 异步 调用 WordDefinition0 7j iX: . 


Private class AccessWebServiceTask extends AsyncTask<String, Void, 
String> 1 
protected String doInBackground (String... urls) { 
return WordDefinition(urls[O0]); 


} 


protected void onPostExecute (String result) { 


Toast .makeText (getBaseContext(), result, Toast.LENGTH LONG). 
show (); 
} 
最 后 ， 使 用 execute0 方 法 异步 访问 Web 服务 。 


//---access a Web Service using GET--- 
new AccessWebServiceTask().execute("apple"); 


10.2 ”使 用 JSON 服务 


在 前 一 节 中 , 通过 利用 HTTP 连接 到 Web 服务 器 和 获取 XML 格式 的 结果 ,学 习 了 
如 何 使 用 XML Web 服务 。 还 学 习 了 如 何 使 用 DOM 解析 XML MMA ZR. (Ae, BE 
计算 量 而 言 ， 操 作 XML 文档 对 于 移动 设备 来 说 是 一 项 代价 高 郧 的 操作 ， 原 因 如 下 : 
e XML 文档 是 元 长 的 ， 它 利用 标签 来 嵌入 信息 ， 其 规模 可 能 会 很 快 变 大 。 一 个 很 大 
的 XML 文档 意味 着 设备 需要 更 大 的 带宽 来 下 载 它 ， 开 销 上 自然 更 高 。 

e XML 文档 更 难处 理 。 正如 之 前 所 示 , 必须 利用 DOM 遍历 树 , 以 便 定 位 想 要 的 信息 。 
Ab, FEA ZA, DOM 本 和 里 需要 在 内 存 中 建立 整个 文档 的 树 结构 。 两 者 都 是 
CPU 和 内 存 密集 型 的 操作 。 
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表示 信息 更 加 有 效 的 一 种 方法 是 使 用 JSON(JavaScript Object Notation) 格 式 。JSON 
是 一 种 轻 量 级 的 数据 交换 格式 , 便于 人 们 读 写 , 同样 它 也 易于 机 器 解析 和 生成 。 下 列 代 
但 段 展示 了 一 段 ISON 消息 。 


[ 
{ 
"appeId":"1", 
"uurwid l1". 
"location":"", 
"5urveyDate":"2008-03 14", 
"SurveyTime":"12:19:47", 
"inputUserId":"1", 
"inputTime":"2008-03-14 12:21:51", 
"modifyTime":"0000-00-00 00:00:00" 
- 
{ 
"apperd" "2", 
CEHEWHI' S AE. 
“location™ =". 
"surveyDate":"2008-03-14", 
"surveyTime" :"227-43:09". 
"inputUserId":"32", 
"inputTime":"2008-03-14 22:43:37", 
"modifyTime":"0000-00-00 00:00:00" 
- 
{ 
“appeId s. 
"suüurvid”:"347, 
"Location": "", 
"surveyDate":"2008-03-15", 
"surveyTime":"07:59:33", 
"AnputUserId":"32",. 
"inputTime":"2008-03-15 08:00:44", 
"modifyTime":"0000-00-00 00:00:00" 
- 
i 
"appeId":"4", 
“SUTVId "IL. 
“location™ e ， 
“surveyDate™ : "2008-03-15", 
"surveyTime":"10:45:42", 
"inputUserId":"1", 
"inputTime":"2008-03-15 10:46:04", 
"modifyTime":"0000-00-00 00:00:00" 
- 
{ 


"appeId" = dios dia : 
weir ei le ， 


"location":"", 
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"surveyDate":"2008-03-16e", 
"surveyTime":"08:04:49", 
"inputUserId":"32", 
"inputTime":"2008-03-16 08:05:26", 
"modifyTime":"0000-00-00 00:00:00" 


- 
{ 
"apperId":"6", 
"Survid":"32". 
"Location" :"". 
"surveyDate":"2008-03-20", 
"surveyTime":"20:19:01", 
"inputUserId":"32", 
"inputTime":"200-03-70 20:19:32", 
"modifyTime":"0000-00-00 00:00:00" 
] 


] 


上 述 的 代码 段 表 示 一 组 参与 调查 的 数据 。 注 意 信息 被 表示 成 键 / 值 对 的 集合 ， 每 个 刍 / 值 
对 组 成 对 象 的 有 序列 表 。 不 同 于 XML，JSON 中 没有 宛 长 的 标签 名 ， 只 有 方 括号 和 花 括号 。 
下 面 的 * 试 一 试 ? 演 示 了 如 何 利用 Android SDK 提供 的 JSONArray 类 和 JSONObject 
类 轻松 地 处 理 JSON 消息 。 
使 用 JSON 服务 


(1) 利用 Eclipse 创建 一 个 新 的 Android 项 目 ， 将 其 命名 为 JSON. 
(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 。 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.JSON" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android: name="android. permission. INTERNET" /> 


<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
<activity 
android: label="@string/app name" 
android:name-".JSONActivity" > 
<intent-filter > 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category. 
LAUNCHER" /> 
«/intent-filter» 
<factivity> 
</application> 


399 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


</manifest> 


(3) 在 JSONActivityjava 文件 中 添加 下 列 粗 体 显示 的 语句 。 


package net. learn2develop.JSON; 


import java.io.BufferedReader; 
import java.io.IOException; 
import java.io.InputStream; 
import java.io.InputStreamReader ; 


import org.apache.http.HttpEntity; 

import org.apache.http.HttpResponse; 

import org.apache.http.StatusLine; 

import org.apache.http.client.ClientProtocolException; 
import org.apache.http.client.HttpClient; 

import org.apache.http.client.methods.HttpGet; 

import org.apache.http.impl.client.DefaultHttpClient; 
import org.json.JSONArray; 

import org.json.JSONObJject; 


import android.app.Activity; 
import android.os.AsyncTask; 
import android.os.Bundle; 
import android.util.Log; 
import android.widget.Toast; 


public class JSONActivity extends Activity { 


public String readJSONFeed (String URL) { 
StringBuilder stringBuilder - new StringBuilder(); 
HttpClient client = new DefaultHttpClient(); 
HttpGet httpGet = new HttpGet (URL); 
try { 
HttpResponse response = client.execute (httpGet); 


StatusLine statusLine = response.getStatusLine(); 
int statusCode = statusLine.getStatusCode(); 
if (statusCode == 200) { 


HttpEntity entity = response.getEntity(); 
InputStream content = entity.getContent(); 
BufferedReader reader = new BufferedReader ( 

new InputStreamReader (content) ) ; 
String line; 


while ((line = reader.readLine()) '= null) { 
stringBuilder.append(line); 
} 
} else { 
Log.e("JSON", "Failed to download file"); 


} 


} catch (ClientProtocolException e) { 
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e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 


return stringBuilder.toString(); 


private class ReadJSONFeedTask extends AsyncTask«String, Void, String> 
{ 
protected String doInBackground(String... urls) { 
return readJSONFeed(urls[0]); 


protected void onPostExecute (String result) { 
try { 
JSONArray jsonArray = new JSONArray (result); 
Log.i("JSON", "Number of surveys in feed: " + 
jsonArray.length ()) ; 


//---print out the content of the json feed--- 
for (int i = 0; i < jsonArray.length(); i++) { 
JSONObject jsonObject = jsonArray.getJSONObJject (i); 
Toast.makeText(getBaseContext(),JjsonObject.getString 
("appeId") 十 
" - " + jsonObject.getString("inputTime"), 
Toast.LENGTH SHORT).show(); 
} 
} catch (Exception e) { 
e.printStackTrace(); JSON 


Hello World, JSONActivity! 


/** Called when the activity is first 
created. */ 
@Override 
public void onCreate (Bundle 
savedlInstanceState) { 
super .onCreate (savedinstanceState) ; 
setContentView (R. layout .main) ; 
new ReadJSONFeedTask () .execute ( 
"http: //extjs.org.cn/extjs/ex 
amples/grid/survey.html"); 


3 - 2008-03-15 08:00:44 


} 
(4) FÈ F11 键 在 Android 模拟 器 中 调试 应 用 程序 。 你 会 图 10-5 
看 到 Toast 类 多 次 出 现 ， 显 示 该 信息 (如 图 10-5 所 示 )。 
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示例 说 明 
在 这 个 项 目 中 ， 首 先 定义 了 readJSONFeed0 方 法 : 


public String readJSONFeed (String URL) { 
StringBuilder stringBuilder = new StringBuilder (); 
HttpClient client = new DefaultHttpClient(); 
HttpGet httpGet = new HttpGet (URL); 


try { 
HttpResponse response = client.execute (httpGet); 
StatusLine statusLine = response.getStatusLine(); 
int statusCode = statusLine.getStatusCode(); 
1f (statusCode == 200) { 
HttpEntity entity = response.getEntity(); 
InputStream content = entity.getContent (); 
BufferedReader reader = new BufferedReader ( 
new InputStreamReader (content) ); 
String line; 
while ((line = reader.readLine()) !- null) { 
stringBuilder.append(line); 
} 
} else | 
Log.e("JSON", "Failed to download file"); 
] 


} catch (ClientProtocolException e) { 
e.printStackTrace(); 

} catch (IOException e) [ 
e.printStackTrace(); 

} 

return stringBuilder.toString(); 


} 
该 方法 简单 地 连接 到 指定 的 URL, 然后 从 Web 服务 器 访 取 啊 应 。 它 返回 字符 串 作 为 结果 。 
为 了 异步 访问 readJSONFeed0 方 法 ， 需 要 创建 AsyncTask0 类 的 子 类 : 


Private class ReadJSONFeedTask extends yncTask<String, Void, String> { 
protected String dolInBackground (String... urls) { 
return readJSONFeed(urls[0]); 


protected void onPostExecute(String result) { 


try { 
JSONArray jsonArray = new JSONArray(result); 
Log.i("JSON", "Number of surveys in feed: ™ + 


jsonArray.length()); 


//---print out the content of the json feed--- 
for (int i = 0; i < jsonArray.length(); i++) { 
JSONObject jsonObject = jsonArray.getJSONOb ject (i); 
Toast.makeText(getBaseContext(), jsonObject.getString 
("appeId") + 
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"— " + jsonObject.getString("inputTime"), 
Toast.LENGTH SHORT) .show(); 
} 


} catch (Exception e) { 
e.printStackTrace(); 


} 
} 


在 doInBackground0 方 法 中 调用 readJSONFeed0 方 法 ， 已 经 提取 的 JSON 字符 串通 过 
onPostExcute(0 方 法 传递 。 本 例 中 使 用 的 ISON 字符 串 (之 前 介绍 过 的 ) 来 日 http://extjs.org.cm/extjs/ 
examples/grip/survey.html . 

为 在 ISON 字符 串 里 获取 对 象 列 表 ， 使 用 了 JSONArray 类 ， 并 向 其 传 入 ISON 源 作为 
该 类 的 构造 函数 。 

JSONArray jsonArray = new JSONArray(result); 
Log.i("JSON", "Number of surveys in feed: ™ + 
jsonArray.length()); 

length0 方 法 在 jsonArray 对 象 里 返回 对 象 的 数目 。 WIA TE jsonArray 对 象 里 的 
对 象 列表 ， 使 用 geUOSNObjectO0 方 法 来 获取 每 个 对 象 : 

//---print out the content of the json feed--- 


for (int i = 0; i < jsonArray.length(); i++) { 
JSONObject jsonObject = jsonArray.getJSONObject (1); 


Toast.makeText (this, jsonObject.getString("appeId") + 
"— " + jsonOb ject .getString ("inputTime™), 
Toast.LENGTH SHORT) .show(); 
} 
getJSONObject0 方 法 返回 一 个 类 型 为 JSONObject 的 对 象 。 为 了 获取 存储 在 对 象 内 部 
的 键 / 值 对 的 值 ， 使 用 了 getString0 方 法 (对 于 其 他 数据 类 型 ， 也 可 以 使 用 getInt(. getLongO 
以 及 getBoolean0 方 法 )。 
最 后 ， 使 用 execute0 方 法 异步 访问 ISON 源 。 


new HReadJSONFeedTask().execute( 
"http://extjs.org.cn/extjs/examples/grid/survey.html"); 


本 例 展示 如 何 使 用 一 个 ISON 服务 并 快速 解析 其 结果 。 更 有 意思 的 一 个 例子 是 使 用 
个 真实 生活 的 场景 :Twitter。 下 列 修 改 能 使 应 用 程序 从 Twitter 中 提取 最 新 的 tweet 并 在 Toast 
类 中 显示 它们 (如 图 10-6 所 示 ): 
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Hello World, |SONActivity! 


Upcoming iOS and Android Courses 
(Singapore) - Nov-Dec 2011 -... http://t.co/ 
RI3eSQM - Thu Oct 13 13:15:24 +0000 
2011 


图 10-6 


private class ReadJSONFeedTask extends AsyncTask<String, Void, String> { 
protected String doInBackground(String... urls) { 
return readJSONFeed(urls[0]); 


protected void onPostExecute(String result) { 
try { 
JSONArray jsonArray = new JSONArray(result); 
Log.i("JSON", "Number of surveys in feed: ™ + 
jsonArray.length()); 


//---print out the content of the json feed--- 
for (int i = 0; i < jsonArray.length(); i++) { 
JSONObject jsonObject = jsonArray.getJSONObject (1); 
[= 
Toast.makeText (getBaseContext() , JsonObject.getString 
("appeId") + 
" — " +4 jsonObject.getString("inputTime"), 
Toast.LENGTH SHORT).show(); 
*/ 


Toast.makeText(getBaseContext(), jsonObject.getString 
("text") + 
" - " + JjsonObject.getString ("created at"), 
Toast.LENGTH SHORT) .show() ; 
} 
} catch (Exception e) { 
e.printStackTrace (); 


/** Called when the activity is first created. */ 
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QOverride 
public void onCreate (Bundle savedInstanceState) | 
super .onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 
/* 
new ReadJSONFeedTask () .execute ( 
"http: //extjs.org.cn/extjs/examples/grid/survey.html1") ; 
*/ 
new ReadJSONFeedTask () .execute ( 
"https: //twitter.com/statuses/user timeline/weimenglee. json") ; 


10.3 BREF ARE 


至 此 ， 已 经 见 过 如 何 通过 HTTP 使 用 XML 服务 和 ISON Web 服务 。 大 多 数 Web 服务 
利用 HTTP 进行 通信 ,它们 本 喘 存 在 一 个 巨大 的 缺点 : 这 些 Web 服务 是 无 状态 的 。 当 利用 
HTTP 与 Web 服务 建立 连接 时 , 每 个 连接 都 被 当 作 一 个 新 连接 一 Web 服务 器 不 维护 与 客户 
"ns E) EE IAE BE e 

设想 一 个 应 用 程序 与 电影 院 订 紧 Web 服务 建立 连接 的 场景 。 当 某 个 客户 端 在 服务 
器 上 订 票 时 ， 其 他 客户 端 直 到 再 次 连接 到 Web 服务 以 获取 最 新 的 座位 信息 时 才 意 识 到 
这 一 点 。 客 户 端 不 断 轮 询 Web 服务 增加 了 不 必要 的 市 宽 ， 并 降低 了 应 用 程序 的 工作 效 
率 。 一 个 更 好 的 解决 方案 是 ， 让 服务 器 维持 和 每 个 客户 端 之 间 的 单独 连接 ， 一 旦 其 他 客 
户 端 预定 某 个 座位 后 ， 就 将 此 消 悬 发送 给 所 有 客户 端 。 

如 果 想 要 应 用 程序 维护 一 个 与 服务 器 的 持续 连接 ,并且 在 修改 发 生 时 接 到 服务 器 的 
通知 ， 需 要 使 用 一 种 叫做 “ 套 接 字 编程 ”的 编程 技术 。 通 过 套 接 字 编程 ， 可 以 在 服务 器 
和 客户 端 之 间 建 立 连 接 。 下 面 的 “ 试 一 试 ” 展 示 了 如 何 建立 一 个 连接 到 和 套 接 字 服 务 器 的 
Android 聊天 客户 请 应 用 程序 。 多 个 应 用 程序 可 以 同时 与 服务 器 建立 连接 并 进行 聊天 。 

试 一 试 与 套 接 字 服务 器 建立 连接 
(1) 利用 Eclipse 创建 一 个 新 的 Android 项 目 ， 将 其 命名 为 Sockets. 
(2) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Sockets" 
android:versionCode-"]" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android: name="android. permission. INTERNET"/> 


<application 
android:icon="@drawable/ic launcher" 
android: label="@string/app name" > 
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<activity 
android: label="@string/app name" 
android:name=".SocketsActivity" > 
<intent-filter > 
«action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category. 
LAUNCHER" /> 
«/intent-filter» 
«/activity» 
</application> 


</manifest> 
(3) YE main.xml 文件 中 添加 下 列 粗 体 显 示 的 语句 ， 用 来 代 奉 TextView: 


<?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«EditText 
android: id="@+id/txtMessage" 
android: layout width="fill parent" 
android:layout height="wrap content" /> 


<Button 
android: layout width="fill parent" 
android: layout height="wrap content" 
android: text="Send Message" 
android: onClick="onClickSend"/> 


<TextView 
android: id="@+id/txtMessagesReceived" 
android: layout width="fill parent" 
android: layout height="200dp" 
android:scrollbars = "vertical" /> 


</LinearLayout> 


(4) 将 一 个 新 的 Java 关 文 件 添 加 到 包 里 ， 并 将 其 命名 为 CommsThread。 使 用 如 下 代码 
填充 CommsThread.java 文件 : 


package net.learn2develop.Sockets; 


import java.io.IOException; 
import java.io.InputStream; 
import java.io.OutputStream; 
import java.net.Socket; 
import android.util.Log; 


public class CommsThread extends Thread { 
private final Socket socket; 
private final InputStream inputStream; 
private final OutputStream outputStream; 


public CommsThread (Socket sock) { 
socket = sock; 
InputStream tmpIn = null; 
OutputStream tmpOut = null; 
try { 
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//---creates the inputstream and outputstream objects 
// for reading and writing through the sockets--- 


tmpIn = socket.getInputStream(); 
tmpOut = socket.getOutputStream(); 
} catch (IOException e) { 


Log.d("SocketChat", e.getLocalizedMessage()); 


} 
inputStream = tmpIn; 
outputstream = tmpOut; 


public void run() { 
//---buffer store for the stream--- 
byte[] buffer = new byte[1024]; 


//---bytes returned from read()--- 
int bytes; 


//---keep listening to the InputStream until an 
// exception occurs--- 
while (true) { 
try { 
//---read from the inputStream--- 
bytes = inputStream.read (buffer); 


//---update the main activity UI--- 
SocketsActivity.UIupdater.obtainMessage ( 
O,bytes, -1, buffer) .sendToTarget() ; 
} catch (IOException e) { 
break ; 


//---call this from the main activity to 
// send data to the remote device--- 
public void write(byte[] bytes) { 
try { 
outputStream.write (bytes) ; 
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} catch (IOException e) { } 


//---call this from the main activity to 
// shutdown the connection--- 
public void cancel() í( 
try { 
socket.close () ; 
} catch (IOException e) { } 


} 
(5) 在 SocketsActivity. java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Sockets; 


import java.io. IOException; 

import java.net.InetAddress; 

import java.net.Socket; 

import java.net.UnknownHostException ; 


import android.app.Activity; 
import android.os.AsyncTask; 
import android.os.Bundle; 
import android.os.Handler; 
import android.os.Message; 
import android.view.View; 
import android.widget.EditText; 
import android.widget.TextView; 


import android.util.Log; 


public class SocketsActivity extends Activity { 
static final String NICKNAME = "Wei-Meng"; 
InetAddress serverAddress; 
Socket socket; 


//---all the Views--- 
static TextView txtMessagesReceived; 
EditText txtMessage; 


//---thread for communicating on the socket--- 
CommsThread commsThread; 


//---used for updating the UI on the main activity--- 
static Handler UIupdater = new Handler() { 
@Override 
public void handleMessage (Message msg) { 
int numOfBytesReceived = msg.argl; 
byte[] buffer = (byte[]) msg.obj; 
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//---convert the entire byte array to string--- 
String strReceived = new String (buffer); 


//---extract only the actual string received--- 
strReceived = strReceived.substring ( 
0, numOfBytesReceived); 


//---display the text received on the TextView--- 

txtMessagesReceived.setText( 
txtMessagesReceived.getText().toString() + 
strReceived); 


}; 


private class CreateCommThreadTask extends AsyncTask 
<Void, Integer, Void> { 
@Override 
protected Void doInBackground (Void... params) { 

try { 
//---create a socket--- 
serverAddress = 

InetAddress.getByName ("192.168.1.142"); 
//--remember to change the IP address above to match your 
own-- 

socket = new Socket(serverAddress, 500); 
commsThread - new CommsThread(socket); 
commsThread.start(); 
//---sign in for the user; sends the nick name--- 
sendToServer (NICKNAME) ; 

} catch (UnknownHostException e) { 
Log.d("Sockets", e.getLocalizedMessage()); 

} catch (IOException e) { 
Log.d("Sockets", e.getLocalizedMessage()); 

} 


return null; 


private class WriteToServerTask extends AsyncTask 
<byte[], Void, Void» { 
protected Void doInBackground(byte[]...data) { 
commsThread.write(data[0]); 
return null; 


private class CloseSocketTask extends AsyncTask 
«Void, Void, Void» { 
@Override 
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protected Void doInBackground(Void... params) { 
try { 
socket.close(); 
} catch (IOException e) { 
Log.d("Sockets", e.getLocalizedMessage()); 
} 


return null; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super. onCreate (savediInstanceState) ; 
setContentView (R.layout.main) ; 


//---get the views--- 

txtMessage = (EditText) findViewById(R.id.txtMessage); 

txtMessagesReceived = (TextView) 
findViewById(R.id.txtMessagesReceived); 


public void onClickSend(View view) { 
//---send the message to the server--- 
sendToServer(txtMessage.getText().toString()); 


private void sendToServer(String message) { 
byte[] theByteArray - 
message.getBytes(); 
new WriteToServerTask().execute(theByteArray); 


@Override 

public void onResume() { 
super.onResume () ; 
new CreateCommThreadTask().execute(); 


@Override 

public void onPause() { 
super.onPause(); 
new CloseSocketTask().execute(); 


} 
(6) 为 了 进行 测试 ， 需 要 使 用 作者 编写 的 一 个 套 接 字 服务 器 应 用 程序 (可 从 Wrox.com 
上 下 载 的 本 书 源 代码 中 提供 了 这 个 应 用 程序 )。 该 应 用 程序 是 一 个 多 用 户 控制 台 应 用 程序 


dieti r^ 昕 本 地 计算 机 的 500 端口 , 并 将 接收 的 消息 传播 给 连接 到 该 服务 器 的 其 他 
WIESE EE 运行 该 服务 器 ， 先 要 在 Windowns 环境 下 打开 一 个 命令 窗口 ， 并 键入 以 下 
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fit 4: C:\>Server.exe Your IP Address. fn, WN 果 你 的 卫 地 址 为 192.168.1.142， 就 需要 


C:\>Server.exe 192.168.1.142 


(7) 在 一 台 真 实 设备 上 配置 应 用 程序 之 前 ， 先 确保 将 设备 连接 到 前 一 步 介 绍 的 运行 服 
务 器 的 计算 机 所 在 的 网 络 。 在 常见 的 设置 中 , 计算 机 连接 到 无 线路 由 器 上 (可 以 是 有 线 或 无 
线 )， 而 设备 无 线 连接 到 同一 个 无 线路 由 器 上 。 一 旦 完成 这 些 步 又， 束 可 以 按 FII 键 在 
Android 设备 上 部 区 应 用 程序 。 

(8) 输入 一 条 消 肯 并 点 击 Send Message 按钮 (如 图 10-7 所 示 )。 

(9) 将 能 看 到 服务 器 接收 的 信息 ， 如 图 10-8 Pra. 


Send Message 


d the chat. 
eryone! 


Wei-Meng has joine 
fei-Meng=Hello ev 


= CAWindows\system32\omd.ene - Serverere 192.168.1142 ESEI" 


ERSTE X 

OX um 

Ue 1—Meny |: joined the chat. 
Sve i-Meny >Hello everyone? 


ei-Heng Lee™Desktop Book Frojects*Beqginning Android Workspace server 
168.1.142 
haz joi 


10-7 10-8 


示例 说 明 

为 了 处 理 套 接 字 通信 和 错综复杂 的 问题 ， 创 建 了 一 个 单独 的 闫 并 将 其 命名 为 Comms- 
Thread( 用 于 通信 线程 )。 该 类 扩展 了 Thread 类 ， 使 所 有 和 套 接 宇通 信 能 在 一 个 不 同 于 主 
UI 线程 的 线程 上 执行 。 


public class CommsThread extends Thread { 


} 
在 该 类 中 声明 3 种 对 象 : 


private final Socket socket; 
private final InputStream inputStream; 
private final OutputStream outputStream; 


第 一 种 是 Socket WH, 它 提供 了 一 个 客户 端 TCP APES. InputStream 对 象 用 于 从 
ER FIERA. OutputStream HSH T n] &fz-r ik XU. 
CommsThread 类 的 构造 图 数 接 受 一 个 Socket 实例 作为 参数 ， 人 然后 尝试 从 套 接 字 连 
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接 获 取 一 个 InputStream 对 象 和 一 个 OutputStream 对 象 : 


public CommsThread(Socket sock) { 
socket = sock; 
InputStream tmpIn = null; 
OutputStream tmpOut = null; 
try { 
//---creates the inputstream and outputstream objects 
// for reading and writing through the sockets--- 
tmpIn = socket.getInputStream(); 
tmpout = socket.getOutputStream(); 
} catch (IOException e) { 
Log.d("SocketChat", e.getLocalizedMessage()); 
} 
inputStream = tmpIn; 
outputstream = tmpOut; 
} 


run0 方 法 ( 当 调 用 该 线程 的 start0 方 法 时 会 访问 mn0 方 法 ) 通 过 使 用 InputStream 对 
象 不 断 读 取 收 到 的 数据 来 侦 听 数据 。 当 接收 到 数据 时 ， 它 会 更 新 主要 活动 的 UI， 将 
个 包含 接收 到 数据 的 消息 传递 给 主要 活动 的 UI: 


public void run() { 
//---buffer store for the stream--- 
byte[] buffer = new byte[1024]; 


//---bytes returned from read()--- 
int bytes; 


//---keep listening to the InputStream until an 
// exception occurs--- 
while (true) | 
try | 
//---read from the inputStream--- 
bytes = inputStream.read(buffer); 


//---update the main activity UI--- 
SocketsActivity.UIupdater.obtainMessage( 

0,bytes, -1, buffer).sendToTarget () ; 
} catch (IOException e) { 


break; 
} 
} 
} 
write(0) 方 法 将 数据 写 入 到 套 接 字 连 接 中 : 
//-—--call this from the main activity to 


// send data to the remote device--- 
public void write(byte[] bytes) { 
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try { 
outputStream.write (bytes); 
} catch (IOException e) { } 
} 


最 后 ，cancel0) 方 法 关闭 了 和 仁 接 字 连接 : 


//---call this from the main activity to 
// shutdown the connection--- 
public void cancel() { 
try 1 
socket.close(); 
} catch (IOException e) { } 
} 


在 SocketsActivity.java 文件 中 ， 创 建 的 3 个 子 类 扩展 了 AsyncTask 类 : 


private class CreateCommThreadTask extends AsyncTask 
<Void, Integer, Void> { 
@Override 
protected Void dolInBackground (Void... params) { 
try | 
//---create a socket--- 
serverAddress - 
InetAddress.getByName("192.168.1.142"); 
socket = new Socket(serverAddress, 500); 
commsThread = new CommsThread(socket); 
commsThread.start(); 
//---sign in for the user; sends the nick name--- 
sendToServer (NICKNAME) ; 
} catch (UnknownHostException e) { 
Log.d("Sockets", e.getLocalizedMessage()); 
} catch (IOException e) { 
Log.d("Sockets", e.getLocalizedMessage()); 
} 


return null; 


private class WriteToServerTask extends AsyncTask 
<byte[], Void, Void> { 
protected Void doInBackground(byte[]...data) | 
commsThread.write(data[0]); 
return null; 


private class CloseSocketTask extends AsyncTask 
«Void, Void, Void» { 

@Override 

protected Void doInBackground (Void... params) { 
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try { 
socket.close(); 


} catch (IOException e) { 
Log.d("Sockets", e.getLocalizedMessage()); 


} 


return null; 


} 
CreateCommThreadTask 类 异步 创建 了 与 服务 器 相连 的 套 接 字 连接 。 对 于 套 接 字 服 


务 右 来 说 ， 连 接 建 并 后 ,客户 端 发 送 的 第 一 个 字符 串 作为 该 客户 端的 名 称 。 因 此 ， 在 套 
接 字 连接 建立 后 ， 立 即 向 服务 器 发 送 一 条 包含 想 使 用 的 客户 端 名 称 的 消息 : 

//---sign in for the user; sends the nick name--- 

sendToServer (NICKNAME) ; 


当 CloseSocketTask 类 关闭 一 条 和 套 接 字 连接 时 ，WriteToServerTask 2$ fb VIE m Jl 25 as 


sendToServer() 方 法 接受 一 个 String 参数 ， 并 将 其 转换 为 一 个 字 节 数组 。 然 后 它 调 
用 WriteToServerTask 类 的 execute0) 方 法 将 数据 异步 发 送 到 服务 器 : 
Private void sendToServer (String message) { 
byte[] theByteArray = 


message .getBytes () ; 
new WriteToServerTask().execute(theByteArray); 


} 
最 后 ， 当 活动 暂停 时 ， 关 闭 套 接 字 连接 ;， 当 活动 恢复 时 ， 重 新 建立 连接 ; 


QOverride 
public void onPause() { 


super.onPause(); 
new CloseSocketTask().execute(); 


) 


@Override 
public void onResume() { 

super .onResume () ; 

new CreateCommThreadtTask () .execute () ; 


10.4 本章 小 结 


本 章 中 介绍 了 应 用 程序 如 何 使 用 HTTP 协议 与 外 界 建立 连接 。 通 过 使 用 HTTP DP 
议 ， 可 以 从 Web 服务 器 下 载 各 种 类 型 的 数据 。 其 中 一 个 优秀 的 应 用 就 是 与 Web 服务 进 
行 通 信 ， 这 需要 解析 XML 文件 。 除 了 XML Web 服务 以 外 ， 还 学 习 了 如 何 使 用 ISON 
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服务 ， 相 比 XML Web 服务 ， 它 更 简便 。 最 后 介绍 了 HTTP 的 替代 方式 : 使 用 套 接 字 进 
行 通信 。 套 接 字 使 应 用 程序 与 服务 器 持续 保持 连接 ,以 使 应 用 程序 在 数据 可 用 时 接收 数 
据 。 从 本 章 的 学 习 中 应 该 重点 知道 : 所 有 同步 操作 都 必须 利用 AsyncTask 类 封装 ， 否 则 
应 用 程序 不 会 在 运行 Honeycomb 或 更 高 版 本 的 设备 上 工作 。 


练习 >] 
1. 为 了 建立 HTTP 连接 ， 需 要 在 AndroidManifest.xml 文件 中 声明 哪些 许可 ? 
2. 有 哪些 类 可 用 于 处 理 JSON YH? 
3. 列举 用 于 执行 后 台 异 步 任务 的 类 。 
附录 C 提供 了 练习 的 答案 。 


本 章 主 要 内 容 


r B 关键 概念 
建立 HTTP 连接 使 用 HttpURLConnection 类 


使 用 Document, DocumentBuilderFactory 和 DocumentBuilder 
类 解析 Web 服务 返回 的 XML 结果 

处 理 JSON 消息 使 用 JSONArray 和 JSONObject 类 
使 用 Socket 类 建立 一 个 TCP 连接 。 使 用 InputStream 对 象 和 


访问 XML Web 服务 


OutputStream 对 象 来 分 别 接收 和 发 送 数据 
3 个 方法 分 别 是 doInBackgroundO . onProgressUpdate() 
AsyncTask 类 中 的 3 个 方法 方法 分 别 是 doInBackgroundO 、onProgressUpdateO 和 


onPostExecute() 
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本 章 将 介绍 以 下 内 容 : 
。 如 何 创建 一 个 在 后 台 运 行 的 服务 

。 如 何在 一 个 单独 的 线程 中 执行 长 时 间 运 行 的 任务 
。 如 何在 一 个 服务 中 执行 重复 的 任务 

。 如 何在 活动 和 服务 间 进 行 通信 


服务 是 Android 中 一 个 在 后 台 运 行 的 应 用 程序 ， 它 无 须 与 用 户 进 行 交 互 。 例 如 ， 在 使 
用 一 个 应 用 程序 时 ， 您 可 能 想 要 在 同一 时 间 播 放 育 景 音乐 。 在 这 种 情况 下 ， 播 放 育 景 音 乐 
的 代码 就 不 需要 与 用 户 进 行 交 互 ， 因 此 它 可 以 作为 一 个 服务 来 运行 。 对 于 不 需要 癌 用 户 展 
示 用 户 界 面 的 情况 下 ， 使 用 服务 也 是 一 个 理想 的 选择 。 用 来 持续 记录 设备 所 在 地 理 坐 标的 
应 用 程序 就 是 一 个 很 好 的 示例 。 在 这 种 情况 下 ， 可 以 写 一 个 服务 在 后 台 执 行 任务 。 在 本 章 
中 ， 将 介绍 如 何 创建 目 己 的 服务 以 及 利用 它们 来 异步 地 执行 后 台 任 务 。 


11.1 创建 目 己 的 服务 


理解 服务 如 何 工 作 的 最 好 方法 就 是 杀 目 创建 一 个 服务 。 下 面 的 “ 试 一 试 ” 回 您 展示 了 
创建 一 个 简单 服务 的 步 又。 后 续 小 节 的 内 容 将 为 这 个 服务 增加 更 多 的 功能 。 全 于 现在 ， 先 
学 习 如 何 局 动 和 停止 服务 。 


am aas 


Services.zip TCX ff ALLA FE Wrox.com £ FE 
(1) 打开 Eclipse， 创 建 一 个 新 的 Android 项 目 ， 命 名 为 Services. 
Q) 在 该 项 目 中 添加 一 个 新 的 名 为 MyService 的 Java 类 文件 。 在 MyService.java 类 文 
件 中 填充 如 下 代码 : 
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package net.learn2develop.Services; 


import 
import 
import 
import 


public 


android.app.Service; 
android.content.Intent; 
android.os.IBinder; 
android.widget.Toast; 


class MyService extends Service { 


@Override 
public IBinder onBind (Intent argO0) { 


return null; 


@O0verride 


public int onStartCommand (Intent intent, int flags, int startId) { 


// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 

Toast.makeText (this, "Service Started", Toast.LENGTH LONG) .show() ; 
return START STICKY; 


@O0verride 


public void onDestroy() { 


) 


super.onDestroy(); 
Toast.makeText(this, "Service Destroyed", Toast.LENGTH LONG). 
show(); 


(3) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version-"1.0" encoding-"utf-8"?- 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"net.learn2develop.Services" 


android:versionCode-"]" 


android:versionName-"1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


«application 


android:icon="@drawable/ic launcher" 
android:label-"(8string/app name" > 
«activity 
android: label="@string/app name" 
android:name=".ServicesActivity" > 
«intent-filter > 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category. 
LAUNCHER" /> 
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«/intent-filter» 
«/activity» 
Xservice android:name=".MyService" /> 
</application> 


</manifest> 


(4) 在 main.xml 文件 中 添加 下 列 粗 体 显示 的 语句 ， 替 换 挤 TextView: 


<?xml version-"1.0" encoding="utf-8"?> 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button android:id="@+id/btnStartService" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Start Service" 
android: onClick="startService"/> 


«Button android: id="@+id/btnStopService" 
android: layout width-"fill parent" 
android: layout height="wrap content" 
android: text="Stop Service" 
android: onClick="stopService" /> 


</LinearLayout> 


(5) 在 ServicesActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Services; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 


public class ServicesActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


public void startService(View view) { 
startService(new Intent(getBaseContext(), MyService.class)); 


public void stopService(View view) { 
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stopService (new Intent(getBaseContext(), MyService.class)); 


| F 
} |^ 5554;ndrokl .0 


] 
P" Services 


(6) 按 F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 — 国有 和 和 

(7) 单 击 Start Service 按钮 将 局 动 服务 (如 图 11-1 所 
示 )。 要 停止 服务 ， 可 单 击 Stop Service 按钮 。 

示例 说 明 

这 个 示例 展示 了 您 可 以 创建 的 最 简单 的 服务 。 当 
然 ， 服务 本 号 是 没有 做 什么 有 用 的 事情 ， 但 它 足以 说 明 
整个 创建 的 过 程 。 

首先 ， 它 定义 了 一 个 扩展 Service 基 类 的 类 。 所 有 


Stop Service 


lin 务 都 扩展 Service 类 ， Service Started 
public class MyService extends Service { 
} 
在 MyService 类 中 ， 实 现 了 3 个 方法 : 图 11-1 


@Override 
public [Binder onBind(Intent arg0) { ... } 
@Override 
public int onStartCommand (Intent intent, int flags, int startId) {... } 
@Override 
public void onDestroy() 1| ... } 
onBind() 方 法 可 以 用 来 将 一 个 活动 绑 定 到 一 个 服务 。 这 反 过 来 又 使 活动 可 以 直接 访问 
服务 内 部 的 成 员 和 方法 。 目 前 ， 上 只 是 为 这 个 方法 返回 null。 在 本 章 的 后 面 ， 您 将 学 习 更 多 
有 关 绑 定 的 内 容 。 
当 使 用 startService077 3: Cis T È) rn 动 服 务 时 将 调用 onStartCommand( ) 方 法 。 
这 个 方法 意味 看 服务 的 局 动 ， 并 为 服务 做 一 些 需 要 做 的 事情 。 此 方法 返回 闻 量 START - 
STICKY， 因 此 只 要 服务 不 被 显 式 地 停止 ， 它 都 将 继续 运行 。 
当 使 用 stopService0 方 法 停止 服务 时 将 调用 onDestroy0 方 法 。 这 一 方法 将 清除 服务 所 
使 用 的 资源 。 
所 有 已 创建 的 服务 必须 在 AndroidManifestxml 文件 中 声明 ， 如 下 所 示 : 


<service android:name=".MyService" /> 


Oy SR ABE Eth Sv. H FE Fr t8 np EARS AT DAYS A a OE AY A Bp ae 
ae > 如 下 所 示 : 
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<service android:name=".MyService"> 


<intent-filter> 
<action android:name="net.learn2develop.MyService" /> 
</intent-filter> 


</service> 


要 局 动 


-个 服务 ， 使 用 startService0 方 法 ， 如 下 所 示 : 


startService (new Intent (getBaseContext(), MyService.class) ); 


如 果 调 用 一 个 外 部 服务 ， 要 按 如 下 所 示 调 用 startService0 方 法 : 


startService (new Intent ("net.learn2develop.MyService") ); 


要 停止 


-个 服务 ， 使 用 stopService0 方 法 ， 如 下 所 示 : 


stopService (new Intent (getBaseContext(), MyService.class)); 
11.1.1 在 服务 中 执行 长 时 间 运 行 的 任务 


由 于 在 上 一 节 中 所 创建 的 服务 没有 做 任何 有 用 的 事情 ， 因 此 在 本 市 中 将 修改 这 一 服 
务 ， 使 其 可 以 执行 一 个 任务 。 在 下 面 的 “ 试 一 试 ” 中 ， 将 模拟 一 个 从 Internet 上 下 载 文件 


的 服务 。 


使 服务 变 得 有 用 


(1) 使 用 在 第 一 个 例子 中 所 创建 的 同一 个 Services WMH, 在 ServicesActivity.java xf 
中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Services; 


import 
import 


import 
import 
import 
import 


public 


java.net .MalformedURLException; 
java.net.URL; 


android.app.Service; 
android.content.Intent; 
android.os.IBinder; 
android.widget.Toast; 


class MyService extends Service { 


@Override 
public [Binder onBind(Intent arg0) 1 


return null; 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 


// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 
//Toast.makeText(this, "Service Started", Toast.LENGTH LONG). 
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} 


show(); 


try i 
int result - DownloadFile (new URL("http://www.amazon.com/ 
somefile.pdf")); 
Toast.makeText(getBaseContext(), 
"Downloaded " + result + " bytes", 
Toast.LENGTH LONG).show(); 
} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 
e.printStackTrace () ; 
} 
return START STICKY; 


private int DownloadFile(URL url) { 


) 


try { 
//---simulate taking some time to download a file--- 
Thread.sleep (5000) ; 

} catch (InterruptedException e) { 
e.printStackTrace(); 

} 

//---return an arbitrary number representing 

// the size of the file downloaded--- 

return 100; 


@Override — 
E Sindo dU 


public void onDestroy() { 


} 


(2) T& F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 

(3) 单 击 Start Service 按钮 启动 服务 来 下 载 文件 。 可 
以 看 到 活动 在 Toast 类 显示 Downloaded 100 bytes if AZ 
前 被 “冻结 ”了 儿 秒 钟 (如 图 11-2 Pitas). 


super.onDestroy(); 
Toast.makeText (this, "Service IB Services 
Destroyed", Toast.LENGTH LONG). 
show (); 


Start Service 


Stop Service 


示例 说 明 
在 这 个 示例 中 ， 服 务 调用 DownloadFileO 方 法 来 模 Soe 


拟 从 一 个 给 


定 的 URL 下 载 文件 。 此 方法 返回 下 载 的 总 
字 节 数 (已 经 硬 编码 为 100)。 为 了 模拟 下 载 文件 时 服务 
所 经 历 的 延迟 , 使 用 Thread.Sleep0 方 法 使 服务 暂停 5 fh 
(5000 毫秒 )。 


图 11-2 


当 启动 服务 时 ， 可 以 注意 到 活动 被 暂停 了 大 约 5 秒 钟 ， 这 正 是 从 Intenet 上 下 载 文件 
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的 时 间 。 在 这 段 时 间 内 ， 整 个 活动 没有 啊 应 ， 这 证 明了 很 重要 的 一 点 : 服务 和 活动 在 相同 
的 线程 上 运行 。 在 这 种 情况 下， 因为 服务 暂停 了 5 秒 钟 ， 所 以 活动 也 一 样 。 

因此 ， 对 于 一 个 长 时 间 运 行 的 服务 ， 将 所 有 长 时 间 运 行 的 代码 放 入 一 个 单独 的 线程 中 
是 很 重要 的 ， 这 样 服务 就 不 会 阻塞 调用 它 的 应 用 程序 了 。 下 和 面 的 “ 试 一 试 ” 将 告诉 您 如 何 
做 到 这 一 点。 


在 服务 中 异步 执行 任务 


Services.zip fU ITU Wrox.com _ FE 


(1) 使 用 在 第 一 个 例子 中 创建 的 Services 项 目 , 在 MyService.java 文件 中 添加 下 列 粗 体 


package net.learn2develop.Services; 


import java.net .MalformedURLException; 
import java.net.URL; 


import android.app.Service; 
import android.content.Intent; 
import android.os.AsyncTask; 
import android.os.IBinder; 
import android.util.Log; 
import android.widget.Toast; 


public class MyService extends Service { 


((|Override 
public IBinder onBind(Intent argO) { 
return null; 


@Override 

public int onStartCommand(Intent intent, int flags, int startId) { 
// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 
//Toast.makeText(this, "Service Started", Toast.LENGTH LONG). 
show (); 


try { 
new DoBackgroundTask(í().execute( 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles. 
pdf")); 
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} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

} 

return START STICKY; 


private int DownloadFile(URL url) { 

try 1 
//---simulate taking some time to download a file--- 
Thread.sleep(5000); 

} catch (InterruptedException e) { 
e.printStackTrace(); 

} 

//---return an arbitrary number representing 

// the size of the file downloaded--- 

return 100; 


private class DoBackgroundTask extends AsyncTask<URL,Integer,Long> { 
protected Long doInBackground(URL... urls) { 
int count = urls.length; 
long totalBytesDownloaded - 0; 
for (int i = 0; i < count; itt) { 
totalBytesDownloaded += DownloadFile(urls[i]); 
//---calculate percentage downloaded and 
// report its progress--- 
publishProgress((int) (((it1) / (float) count) * 100)); 
} 


return totalBytesDownloaded; 


protected void onProgressUpdate (Integer... progress) { 
Log.d("Downloading files", 
String.valueOf(progress[0]) + "% downloaded"); 
Toast.makeText(getBaseContext(), 
String.valueOf(progress[0]) + "% downloaded", 
Toast.LENGTH LONG).show(); 


protected void onPostExecute(Long result) { 
Toast.makeText(getBaseContext(), 
"Downloaded " + result + " bytes", 
Toast.LENGTH LONG).show(); 
stopSelf(); 


@Override 
public void onDestroy() { 
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super.onDestroy(); 
Toast.makeText (this, "ServiceDestroyed", Toast. 
LENGTH LONG) .show(); 


) 


(2) 按 Fll RETE Android 模拟 器 上 调试 应 用 程序 。 

(3) 单 击 Start Service 按钮 。Toast 类 将 显示 一 个 消 县 表明 下 载 完成 的 百分比 。 可 以 看 
| 4 ^ff: 2596. 50%, 75% 100%. 

(4) 还 可 以 看 到 在 LogCat 窗口 中 的 如 下 输出 内 容 : 

12-06 01:58:24.967: D/Downloading files(6020): 25% downloaded 

12-06 01:58:30.019: D/Downloading files (6020): 50% downloaded 


12-06 01:58:35.078: D/Downloading files (6020): 75% downloaded 
12-06 01:58:40.096: D/Downloading files(6020): 100% downloaded 


示例 说 明 

这 个 示例 说 明了 可 以 在 您 的 服务 中 异步 执行 任务 的 一 种 方法 。 通 过 创建 一 个 扩展 
AsyncTask 类 的 内 部 类 来 做 到 这 一 点 。AsyncTask 类 使 您 能 够 在 后 台 执 行 ， 而 无 须 手 动 操纵 
线程 和 处 理 程序 。 


DoBackgroundTask 类 通过 指定 3 个 泛 型 类 型 来 扩展 AsyncTask 类 : 


private class DoBackgroundTask extends AsyncTask<URL, Integer, Long>{ 


这 里 指定 的 3 种 类 型 为 URL, Integer 和 Long. iX 3 种 类 型 指定 了 以 下 3 种 方法 所 用 
到 的 数据 类 型 ， 这 些 方法 将 在 一 个 AsyncTask 类 中 来 实现 : 
e doInBackground() 一 一 这 个 方法 接受 一 个 先前 指定 的 第 一 个 泛 型 类 型 的 数组 。 在 这 
里 ， 类 型 是 URL。 这 个 方法 用 于 放置 需要 长 时 间 运 行 的 代码 并 在 后 台 线 程 中 执行 。 
为 了 报告 任务 的 进度 ， 调 用 publishProgress0 〇 方法 ， 它 将 调用 第 二 个 方法 
onProgressUpdateO0， 这 个 方法 在 一 个 AsyncTask 类 中 实现 。 此 方法 的 返回 类 型 使 用 
先前 指定 的 第 三 个 泛 型 类 型 ， 本 例 中 是 Long。 
e onProgressUpdate0 一 一 这 一 方法 在 UI 线 程 中 局 动 并 在 调用 publishProgress0) 方 法 时 调 
用 。 它 接受 一 个 先前 指定 的 第 二 个 泛 型 类 型 的 数组 。 在 这 里 ， 类 型 是 Integer。 使 用 
这 一 方法 回 用 户 报 告 后 台 任 务 的 进度 。 
e OHPostExecute(0 一 一 这 一 方法 在 UI 线程 中 启动 并 在 doInBackground0 方 法 执行 完毕 
后 调用 。 这 一 方法 接受 一 个 先前 指定 的 第 三 个 泛 型 类 型 的 参数 ， 本 例 中 是 Long. 
图 11-3 总 结 了 在 AsyncTask 类 的 子 类 中 指定 的 类 型 和 它们 与 3 个 方法 的 关系 。 
要 在 后 台 下 载 多 个 文件 , 则 创建 DoBackgroundTask 类 的 一 个 实例 , 然后 通过 传 入 一 个 
URL 数组 来 调用 其 execute0 方 法 : 
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private class DqBackgroundTask extends AsyncTas 
protected Long doInBackground(URL... urls) 
int count z urls.length; 
long totalBytesDownloaded - 8; 
for (int i = 8; i « count; i++) 
ae 十 = De s[1]);, 
-calculate per E downloaded And 


K<URL|, Integer, | Long>|{ 


// report its progre 
LM ine: (C) / (float) cod4nt) * 188)); 


) 
return totalBytesDownloaded; 
J 


protected void onProgressUpdate(Integer.../progress) { 
Log.d("Downloading files", 
String. valueOf(progress[@]) A "X downloaded"); 
Toast.maheText(getBaseContext(), 
String.valueOf(progress[0]) ¥ "* downloaded", 
Toast. LENGTH LONG).show(); A 


Toast. make Text (getBaseContext(), 
"Downloaded " + result + " bytes", 
Toast.LENGTH LONG).show(); 
stopSelf(); 
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try { 
new DoBackgroundTask () .execute ( 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles.pdf")); 


} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(]):; 


} 


前 述 的 代码 使 服务 在 后 台 下 载 文 件 ， 并 用 文件 下 载 的 百分比 形式 报告 进度 。 更 重要 的 
ri 当 在 后 台 通 过 一 个 单独 的 线程 下 载 文 件 时 ， 活动 仍然 保持 啊 应 。 
注意 ， 当 后 台 线 程 执 行 完毕 时 ， 需 要 手动 调用 stopSelf0 方 法 来 停止 服务 : 


protected void onPostExecute(Long result) { 


Toast.makeText (getBaseContext (), 
"Downloaded ”+ result + " bytes", 
Toast.LENGTH LONG) .show(); 

stopSelf(); 

} 


stopSelfO 方 法 相当 于 调用 stopService0 方 法 来 停止 服务 。 
11.1.2 ”在 服务 中 执行 重复 的 任务 


除了 在 服务 中 执行 长 时 间 运 行 的 任务 ， 一 些 重复 的 任务 也 会 在 服务 中 执行 。 例 如 ， 您 
可 能 编写 了 一 个 一 直 在 后 台 运 行 的 闹钟 服务 。 在 这 种 情况 下 ， has 
代码 来 检查 是 否 到 了 一 个 预 设 的 时 间 以 便 发 出 提醒 。 要 运行 一 个 按 固 定 的 时 间 间 隔 执行 的 
代码 块 ， 可 以 在 服务 中 使 用 Timer 类 。 下 面 的 “ 试 一 试 ” 将 告诉 您 怎么 做 。 
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使 用 Timer 类 来 运行 重复 的 任务 


Services.zip fCfZ X ff HJ LAE Wrox.com E FE 


(1) 再 次 使 用 Services WH, YE MyService java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Services; 


import 
import 
import 
import 


import 
import 
import 
import 
import 
import 


public 


java.net .MalformedURLException; 
java.net.URL; 

java.util.Timer; 
java.util.TimerTask; 


android.app.Service; 
android.content.Intent; 
android.os.AsyncTask; 
android.os.IBinder; 
android.util.Log; 
android.widget.Toast; 


class MyService extends Service { 


int counter = 0; 
static final int UPDATE INTERVAL = 1000; 
private Timer timer = new Timer (); 


@Override 
public [Binder onBind(Intent argQ) { 


return null; 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 


// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 
//Toast.makeText (this, "Service Started", Toast.LENGTH LONG) .show() ; 


doSomethingRepeatedly () ; 


try | 
new DoBackgroundTask () .execute ( 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles. 
pdf")); 


} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
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} 
return START STICKY; 


private void doSomethingRepeatedly() { 
timer .scheduleAtFixedRate (new TimerTask() { 
public void run() { 
Log.d("MyService", String.valueOf (++counter) ); 


} 
}, 0, UPDATE INTERVAL); 


private int DownloadFile(URL url) I 

try | 
//---simulate taking some time to download a file--- 
Thread.sleep(5000); 

} catch (InterruptedException e) { 
e.printStackTrace(); 

} 

//---return an arbitrary number representing 

// the size of the file downloaded--- 


return 100; 


private class DoBackgroundTask extends AsyncTask<URL, Integer, Long>{ 
protected Long doInBackground(URL... urls) | 
int count = urls.length; 
long totalBytesDownloaded - 0; 
for (int i = 0; i < count; i+t) { 
totalBytesDownloaded += DownloadFile(urls[i]); 
//---calculate percentage downloaded and 
// report its progress--- 
publishProgress((int) (((i-1) / (float) count) * 100)); 
} 


return totalBytesDownloaded; 


protected void onProgressUpdate (Integer... progress) { 
Log.d("Downloading files", 
String.valueOf(progress[0]) + " downloaded"); 
Toast.makeText(getBaseContext(), 
String.valueOf(progress[0]) + "$ downloaded", 
Toast.LENGTH LONG).show(); 


protected void onPostExecute(Long result) | 
Toast.makeText(getBaseContext(), 
"Downloaded ”+ result + " bytes", 
Toast.LENGTH LONG).show(); 
stopSelf(); 
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} 


@Override 
public void onDestroy() { 
super.onDestroy(); 


if (timer !- null) { 
timer .cancel () ; 


} 


Toast.makeText (this, "Service Destroyed", Toast.LENGTH LONG). 
show (); 


} 


(2) IÈ F11 BEE Android 模拟 器 上 调试 应 用 程序 。 

(3) i Start Service 按钮 。 

(4) 观察 在 LogCat 窗口 中 显示 的 输出 内 容 ， 如 下 所 示 : 

12-06 02:37:54.118: D/MyService (7752): 

12-06 02:37:55.109: D/MyService (7752): 

12-06 02:37:56.120: D/MyService(7752): 

12-06 02:37:57.111: D/MyService (77/52): 

12-06 02:37:58.125: D/MyService (7752): 

12-06 02:37:59.137: D/MyService (7752): 

示例 说 明 

在 这 一 示例 中 ， 创 建 了 一 个 Timer 对 象 并 在 您 已 经 定义 的 doSomethingRepeatedly() 77 
法 中 调用 这 一 对 象 的 scheduleAtFixedRateO) 方 法 : 


private void doSomethingRepeatedly() { 
timer.scheduleAtFixedRate( new TimerTask() { 
public void run() | 
Log.d("MyService", String.valueOf (++counter)); 
} 
}, 0, UPDATE INTERVAL); 
} 


将 一 个 TimerTask 类 的 实例 传递 给 scheduleAtFixedRate0 方 法 , 以 便 可 以 重复 执行 位 于 
rng0 方 法 中 的 代码 块 。 scheduleAtFixedRate0 方 法 的 第 二 个 参数 指定 了 在 第 一 次 执行 之 前 
的 时 间 间 隔 ， 以 蝇 秒 为 单位 。 第 三 个 参数 以 度 秒 为 单位 ,指定 了 后 继 执行 之 间 的 时 间 间 陋 。 

在 前 面 的 示例 中 ， 基 本 上 每 1 秒 钟 (1000 毫秒 ) 打 印 一 次 计数 器 的 值 。 这 一 服务 重复 打 
印 counter 的 值 ， 直 到 服务 终止 。 

@Override 
public void onDestroy() | 
super.onDestroy(); 
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if (timer !- null) { 
timer.cancel(); 


} 


Toast.makeText (this, "Service Destroyed", Toast.LENGTH LONG) .Show () 7 
} 


对 于 scheduleAtFixedRate0 方 法 ， 不 管 每 个 任务 需要 多 长 时 间 ， 代 码 都 是 按照 固定 的 
时 间 间 隔 执行 。 例 如 ， 如 果 run0 方 法 内 的 代码 需要 两 秒 钟 来 完成 ， 那 么 第 二 个 任务 将 在 第 
一 个 任务 结束 后 立 妈 开始。 同样， 如 果 延 人 运 时 间 设 置 为 3 秒 ， 而 完成 任务 只 需要 2 秒 ， 那 
么 第 二 个 任务 在 开始 前 将 等 待 1 秒 钟 。 

另外 ， 注 意 在 onStartCommand0 方 法 中 直接 调用 了 doSomethingRepeatedlyQ 7772, ifi 
不 需要 将 其 封装 到 AsyncTask 类 的 一 个 子 类 中 。 这 是 因为 TimerTask 类 本 身 实现 了 了 Runnable 
接口 ， 该 接口 允许 在 一 个 单独 的 线程 上 运行 。 


11.1.3 ”使 用 IntentService 在 单独 的 线程 上 执行 异步 任务 


本 章 的 前 面部 分 讲述 了 如 何 使 用 startService0O 方 法 启动 服务 以 及 使 用 stopService0 方 法 
停止 服务 。 我 们 还 学 习 了 如 何在 一 个 单独 的 线程 上 执行 长 时 间 运 行 的 任务 一 一 与 主 调 活 动 
不 是 同一 个 线程 。 重 要 的 是 需要 注意 ， 一 旦 服务 执行 完 任务 ， 应 尽快 停止 ， 防 正 它 继续 占 
用 宝贵 的 资源 。 这 就 是 为 什么 当 任务 完成 时 需要 使 用 stopSelf0 方 法 来 停止 它 的 原因 。 遗 憾 
的 是 ， 很 多 开发 人 员 在 任务 已 经 完成 后 向 各 后记 将 服务 终止 。 为 了 能 较 容 易 地 创建 一 个 服 
务 ， 使 其 异步 运行 一 个 任务 并 在 结束 时 目 行 终止 ， 可 以 使 用 IntentService 25. 

IntentService 类 是 可 以 按 需 处 理 异 步 请 求 的 Service 的 基 类 。 它 像 一 个 普通 服务 那样 启 
动 ， 在 一 个 工作 者 线程 中 执行 其 任务 并 在 任务 完成 时 上 自行 终止 。 下 面 的 “ 试 一 试 ” 演 示 了 
如 何 使 用 IntentService 25. 


试 一 试 使 用 IntentService 类 自动 停止 一 个 服务 


Services 1C X f£ HJ LA f£ Wrox.com E FE 
(1) 使 用 第 一 个 示例 中 创建 的 Services 项 目 ， 添 加 一 个 新 的 类 文件 MyIntentService java. 
(2) 在 MyIntentService.java 文件 中 输入 以 下 内 容 : 
package net.learn2develop.Services; 


import java.net.MalformedURLException; 
import java.net.URL; 


import android.app.IntentService; 
import android.content.Intent; 
import android.util.Log; 
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public class MyIntentService extends IntentService { 


public MyIntentService() { 
super("MyIntentServiceName"); 


} 
@Override 
protected void onHandleIntent(Intent intent) { 
try { 
int result = 
DownloadFile (new URL ("http://www.amazon.com/somefile. 
pdf")); 
Log.d("IntentService", "Downloaded " + result + " bytes"); 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
} 
} 


private int DownloadFile(URL url) { 
try { 
//---simulate taking some time to download a file--- 
Thread.sleep (5000) ; 
} catch (InterruptedException e) { 
e.printStackTrace(); 
} 


return 100; 
} 


(3) 在 AndroidManifest.xml 文件 中 添加 下 列 粗 体 显示 的 语句 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.Services" 
android:versionCode-"1" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 


<application 

android:icon="@drawable/ic launcher" 

android: label="@string/app name" > 

<activity 
android: label="@string/app name" 
android:name-".ServicesActivity" > 
«intent-filter > 

<action android:name="android.intent.action.MAIN" /> 


«category android:name="android.intent.category.LAUNCHER"/> 


«/intent-filter-» 
<factivity> 
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«service android:name=".MyService"> 
<intent-filter> 
<action android:name="net.learn2develop.MyService" /> 
</intent-filter> 
</service> 


<service android:name=".MyIntentService" /> 
«/application» 
«/manifest» 


(4) 在 ServicesActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


public void startService (View view) { 
//startService (new Intent (getBaseContext(), MyService.class) ); 
//OR 
//startService (new Intent ("net.learn2develop.MyService") ); 
startService (new Intent (getBaseContext(), MyIntentService.class) ) ; 
} 


(5) 按 F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 
(6) 单 击 Start Service 按钮 。 大 约 5 秒 钟 之 后 ， 应 该 可 以 在 LogCat 窗口 中 观察 到 以 下 


语句 : 
12-06 13:35:32.181: D/IntentService (861): Downloaded 100 bytes 
示例 说 明 
首先 ， 定 义 了 MyIntentService 类 ， 它 扩展 IntentService 类 而 非 Service 25: 


public class MyIntentService extends IntentService | 


} 


ri 8 SE WIR PSR BA 4] 368 E BE A) Hs: PASE SS PRCA SEB) ed FS 


public MyIntentService() { 
super("MyIntentServiceName"); 


} 


然后 ， 实 现 onHandleIntent0 方 法 ， 它 在 一 个 工作 者 线程 上 执行 : 


@Override 
protected void onHandleIntent (Intent intent) { 
try { 
int result = 
DownloadFile (new URL ("http: //www.amazon.com/somefile.pdf") ) ; 
Log.d("IntentService", "Downloaded " + result + " bytes"); 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
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需要 在 一 个 单独 的 线程 中 执行 的 代码 可 以 放 在 onHandleIntent0 方 法 中 ， 如 从 服务 器 下 
载 一 个 文件 。 当 代码 执行 完毕 ， 线 程 被 终止 ， 并 且 服 务 目 动 停止 。 


11.2 ”在 服务 和 活动 之 间 通 信 


服务 通常 只 是 在 自己 的 线程 中 执行 ， 独 立 于 调用 它 的 活动 。 如 果 您 只 是 想 让 服务 定期 
执行 某 些 任务 并 且 不 需要 将 服务 的 状态 通知 给 活动 的 话 ， 这 并 不 造成 任何 问题 。 例 如 ， 您 
可 能 有 一 个 将 设备 的 地 理 位 置 定 期 记录 到 数据 库 中 的 服务 。 在 这 种 情况 下 ， 您 的 服务 没有 
必要 与 任何 活动 进行 交互 ， 因 为 其 主要 目的 是 将 坐标 保存 到 数据 库 中 。 然 而 ， 假 设 您 想 监 
控 一 个 特定 的 位 置 。 当 服务 记录 一 个 靠近 您 正在 监控 的 位 置 的 地 址 时 ， 它 可 能 需要 将 这 一 
信息 传递 给 活动 。 在 这 种 情况 下 ， 就 需要 为 服务 和 活动 的 交互 设计 一 种 方法 。 

下 面 的 “ 试 一 试 ” 展 示 了 服务 是 如 何 使 用 一 个 BroadcastReceiver 来 与 活动 通信 的 。 


从 一 个 服务 来 启动 一 个 活动 


Services fC£Z X f£ HJ BUE Wrox.com E FE 


(1) 使 用 前 面 创建 的 Services WH, 7E MyIntentServicejava 文件 中 添加 下 列 粗 体 显示 
的 语句 : 


package net.learn2develop.Services; 


import java.net.MalformedURLException; 
import java.net.URL; 


import android.app.IntentService; 
import android.content.Intent; 
import android.util.Log; 


public class MyIntentService extends IntentService { 


public MyIntentService() { 
super ("MyIntentServiceName"); 


} 


@Override 
protected void onHandleIntent (Intent intent) { 
try { 
int result = 
DownloadFile (new URL("http://www.amazon.com/somefile. 
pdf")); 
Log.d("IntentService", "Downloaded ”+ result + " bytes"); 


//---send a broadcast to inform the activity 


433 


434 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


) 


// that the file has been downloaded--- 

Intent broadcastIntent = new Intent(); 
broadcastIntent.setAction("FILE DOWNLOADED ACTION"); 
getBaseContext ().sendBroadcast(broadcastIntent); 


} catch (MalformedURLException e) { 
e.printStackTrace(); 


private int DownloadFile(URL url) { 
try | 
//---simulate taking some time to download a file--- 
Thread.sleep(5000); 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


} 


return 100; 


(2) 在 ServicesActivity.java 文件 中 添加 下 列 粗 体 显示 的 语句 : 


package net.learn2develop.Services; 


import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.content.BroadcastReceiver; 
android.content.Context; 
android.content.Intent; 
android.content.IntentFilter; 
android.os.Bundle; 
android.view.View; 
android.widget.Toast; 


class ServicesActivity extends Activity { 


IntentFilter intentFilter; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


GOverride 
public void onResume() { 


super.onResume(); 


//---intent to filter for file downloaded intent--- 
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intentFilter = new IntentFilter(); 
intentFilter.addAction("FILE DOWNLOADED ACTION") ; 


//---register the receiver--- 
registerReceiver(intentReceiver, intentFilter) ; 
} 
@Override 


public void onPause() { 
super .onPause() ; 


//---unregister the receiver--- 
unregisterReceiver (intentReceiver); 


public void startService(View view) { 
//startService (new Intent (getBaseContext(), MyService.class)); 
/ /OR 
//startService (new Intent("net.learn2develop.MyService")); 
startService (new Intent (getBaseContext (),MyIntentService.class) ); 


public void stopService (View view) { 
stopService (new Intent (getBaseContext(), MyService.class) ); 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() { 
@Override 
public void onReceive (Context context, Intent intent) { 
Toast. makeText (getBaseContext(), "File downloaded!", 
Toast.LENGTH LONG) .show() ; 


F 
四 5bAndroid 40 


的 Services 


} Start Service 


Stop Service 


(3) 按 F11 键 在 Android 模拟 器 上 调试 应 用 程序 。 

(4) 单 击 Start Service 按钮 。 大 约 5 秒 钟 后 ，Toast 类 将 
显示 一 个 消 县 ， 表 明文 件 已 经 被 下 载 (如 图 11-4 所 示 )。 

示例 说 明 

为 了 在 一 个 服务 执行 结束 后 可 以 通知 一 个 活动 ， 需 要 使 
用 sendBroadcast0 方 法 广播 一 个 意图 : 


QOverride 
protected void onHandleIntent(Intent intent) 


File downloaded! 


try { 图 11-4 
int result = 


DownloadFile (new URL ("http://www.amazon.com/somefile. 
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pdf")); 
Log.d("IntentService", "Downloaded " + result + " bytes"); 


//---send a broadcast to inform the activity 

// that the file has been downloaded--- 

Intent broadcastIntent = new Intent(); 
broadcastIntent.setAction("FILE DOWNLOADED ACTION"); 
getBaseContext().sendBroadcast(broadcastIntent); 


} catch (MalformedURLException e) { 
e.printStackTrace(); 


) 


广播 的 这 一 意图 的 动作 被 设置 为 FILE DOWNLOADED ACTION, 这 意味 着 侦 听 这 
意图 的 任何 活动 都 将 被 调用 。 因 此 ， 在 ServicesActivityjava 文件 中 ， 使 用 IntentFilter 类 的 
registerReceiver() 方 法 来 侦 听 这 个 意图 : 

@Override 


public void onResume() { 
super.onResume () ; 


//---intent to filter for file downloaded intent--- 
intentFilter = new IntentFilter(); 
intentFilter.addAction ("FILE DOWNLOADED ACTION"); 


//---register the receiver--- 
registerReceiver(intentReceiver, intentFilter); 


当 收 到 这 一 意图 后 ， 它 将 局 动 一 个 已 定义 的 BroadcastReceiver 类 的 实例 : 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() { 
@Override 
public void onReceive (Context context, Intent intent) { 
Toast.makeText(getBaseContext(), "File downloaded!", 
Toast.LENGTH LONG).show(); 


ls 


注意 : 第 8 章 详细 讨论 了 BroadcastReceiver X. 


在 本 例 中 ， 显 示 了 消息 “File downloaded!”。 当 然 ， 如 果 需 要 从 服务 传递 一 些 数 据 给 
活动 ， 可 以 使 用 Intent 对 象 。 下 一 节 将 讨论 这 个 问题 。 
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11.3 ”将 活动 绑 定 到 服务 


到 目前 为 止 ， 您 已 经 了 解 了 如 何 创建 服务 ， 如 何 调用 服务 以 及 任务 完成 后 如 何 终止 服 
务 。 所 有 已 经 看 到 的 服务 都 很 简单 一 一 要 么 启动 一 个 计数 器 并 以 固定 的 时 间 间 隔 递增 ， 要 
么 从 Internet 上 下 载 一 组 固定 的 文件 。 然 而 ， 现 实 世 界 中 的 服务 通 音 更 为 复 菏 ， 需 要 传递 
数据 来 使 它们 为 您 正确 地 工作 。 

使 用 先前 展示 的 下 载 一 组 文件 的 服务 ， 假 设 现在 想 让 主 调 活动 来 决定 下 载 什 么 样 的 文 
件 ， 而 不 是 在 服务 中 徘 便 编码 实现 ， 那 么 就 需要 按 以 下 方式 来 做 。 

首先 ， 在 主 调 活动 中 ， 创 建 一 个 ntent TR, FEMS AM: 


public void startService(View view) { 
Intent intent — new Intent(getBaseContext(), MyService.class); 
} 


然后 ,创建 一 个 URL 对 象 的 数组 ， 并 通过 Intent 对 象 的 putExtra0 方 法 将 其 赋 给 Intent 
对 象 。 最 后 ， 使 用 Intent 对 象 启动 服务 : 


public void startService(View view) { 
Intent intent = new Intent (getBaseContext(), MyService.class) ; 
try { 
URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles. 
pdt") }; 
intent.putExtra("URLs", urls) ; 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
} 
startService (intent) ; 


} 


注意 ，URL 数组 作为 一 个 Object 数组 被 赋 给 了 Intent X1 Z. 
在 服务 端 ， 需 要 通过 onStartCommand0 方 法 中 的 Intent 对 象 提取 传 入 的 数据 : 


@Override 

public int onStartCommand(Intent intent, int flags, int startId) { 
// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 
Object[] objUrls - (Object[]) intent.getExtras().get("URLs"); 
URL[] urls = new URL[objUrls.length] ; 
for (int i-0; i«objUrls.length-1; i++) { 

urls[i] = (URL) objUrls[i]; 

} 
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new DoBackgroundTask () .execute (urls); 
return START STICKY; 
} 

上 述 代码 首先 使 用 getExtras() 方 法 提取 数据 来 返回 一 个 Bundle 对 象 。 然 后 使 用 getO 
方法 以 Object 数组 形式 提取 出 URL 数组 。 由 于 在 Java 中 ， 不 能 直接 将 数组 从 一 个 类 型 转 
换 到 男 一 个 类 型 ， 因 此 必须 创建 一 个 循环 ， 对 数组 中 的 每 个 成 员 单 独 进行 转换 。 最 后 ， 通 
过 将 URL 数组 传递 给 execute0 方 法 来 执行 后 台 任 务 。 

这 是 活动 可 以 将 值 传递 给 服务 的 一 种 方式 。 正 如 您 看 到 的 ， 如 果 要 将 比较 复杂 的 数据 
传递 给 服务 ， 就 必须 做 一 些 额 外 的 工作 ， 以 确保 数据 被 正确 传递 。 传 递 数据 的 一 个 更 好 的 
办 法 是 直接 将 活动 绑 定 到 服务 上 ， 这 样 活动 可 以 直接 调用 服务 的 任何 公共 成 员 和 方法 。 下 
面 的 “ 试 一 试 ” 展 示 了 如 何 将 活动 绑 定 到 服务 上 。 


直接 通过 绑 定 访问 属性 成 员 


Services.zip CHIX fF BJ LAGE Wrox.com FF 


(1) 使 用 先前 创建 的 Services 项 目 , 在 MyService.java 文件 中 添加 下 列 粗 体 显示 的 语句 
(注意 这 是 在 修改 现 有 的 onStartCommand0 方 法 ): 


import android.os.Binder; 
import android.os.IBinder; 


public class MyService extends Service | 
int counter = 0; 
URL[] urls; 
static final int UPDATE INTERVAL - 1000; 
private Timer timer = new Timer(); 
private final IBinder binder - new MyBinder(); 


public class MyBinder extends Binder 1 
MyService getService() { 
return MyService.this; 
} 
} 


@Override 
public IBinder onBind(Intent argO0) | 
return binder; 


) 


@Override 

public int onStartCommand(Intent intent, int flags, int startId) { 
// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG) .show() ; 
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new DoBackgroundTask () .execute (urls); 
return START STICKY; 


} 
private void doSomethingRepeatedly() { i- } 
private int DownloadFile(URL url) { ... } 


private class DoBackgroundTask extends AsyncTask<URL, Integer, Long> {... } 


@Override 


public void onDestroy() { ... } 


} 


(2) 在 ServicesActivityjava 文件 中 添加 下 列 粗 体 显 示 的 语句 (注意 对 现 有 startService() 


import 
import 
import 
import 
import 


public 


android. content.ComponentName ; 
android.os.IBinder; 
android.content.ServiceConnection; 
java.net.MalformedURLException ; 
java.net.URL; 


class ServicesActivity extends Activity { 


IntentFilter intentFilter; 


MyService serviceBinder; 


Intent 1; 


private ServiceConnection connection = new ServiceConnection() I 


public void onServiceConnected ( 
ComponentName className, IBinder service) { 
//--called when the connection is made-- 
serviceBinder = ((MyService.MyBinder) service) .getService() ; 
try { 
URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles. 
pdf") }; 
//---assign the URLs to the service through the 
// serviceBinder object--- 
serviceBinder.urls = urls; 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
} 


startService (1i); 
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public void onServiceDisconnected(ComponentName className) { 
//---called when the service disconnects--- 


serviceBinder = null; 


public void startService (View view) { 
1 = new Intent (ServicesActivity.this, MyService.class); 
bindService(i, connection, Context.BIND AUTO CREATE) ; 


@Override 
public void onCreate (Bundle savedInstanceState) [| ... |] 


@Override 
public void onResume() { ... } 


@Override 
public void onPause() { ... } 


public void stopService (View view) { ... } 


private BroadcastReceiver intentReceiver = new BroadcastReceiver() { 


.* =. E 


); 
} 
(3) 按 Fl11 键 调试 应 用 程序 。 单 击 Start Service 按钮 将 正常 启动 服务 。 
示例 说 明 
为 了 将 活动 绑 定 到 一 个 服务 ， 必 须 首 先 在 服务 中 声明 一 个 扩展 Binder 类 的 内 部 类 : 


public class MyBinder extends Binder { 
MyService getService() { 
return MyService.this; 


} 
在 这 个 类 中 实现 getService0 方 法 ， 这 一 方法 返回 服务 的 一 个 实例 。 然 后 创建 一 个 
MyBinder 类 的 实例 : 
private final IBinder binder = new MyBinder(); 
还 要 修改 onBind0 方 法 来 返回 MyBinder 实例 : 


QOverride 
public [Binder onBind(Intent arg0) { 
return binder; 


第 11 章 开发 Android 服务 


在 onStartCommand0 方 法 中 ， 使 用 先前 在 服务 中 作为 公共 成 员 声 明 的 urls 数组 调用 
execute() 7] 1À:: 


public class MyService extends Service { 
int counter = 0; 
URL[] urls; 


@Override 

public int onStartCommand(Intent intent, int flags, int startId) { 
// We want this service to continue running until it is explicitly 
// stopped, so return sticky. 
Toast.makeText(this, "Service Started", Toast.LENGTH LONG).show(); 
new DoBackgroundTask().execute(urls); 
return START STICKY; 


下 一 步 要 做 的 就 是 从 活动 中 直接 对 这 个 URL 数组 进行 设置 。 
在 ServicesActivityjava 文件 中 ， 首 先 声明 服务 的 一 个 实例 和 一 个 Intent 对 象 : 


MyService serviceBinder; 
Intent 1i; 


serviceBinder 对 象 将 用 作 指 向 服务 的 引用 ， 可 以 直接 访问 它 。 
然后 创建 一 个 ServiceConnection 类 的 实例 以 便 监 控 服 务 的 状态 : 


private ServiceConnection connection = new ServiceConnection() { 
public void onServiceConnected ( 
ComponentName className, IBinder service) { 


//---called when the connection is made--- 
ServiceBinder = ((MyService.MyBinder) service) .getService(); 
try 1 


URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles. 
pdf") }; 
//---assign the URLs to the service through the 
// serviceBinder object--- 
serviceBinder.urls — urls; 
} catch (MalformedURLException e) { 
e.printStackTrace(); 
} 
startService (1); 
} 
public void onServiceDisconnected (ComponentName className) { 
//---called when the service disconnects--- 
serviceBinder - null; 
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}s 


需要 实现 两 个 方法 :onServiceConnected0 和 onServiceDisconnected(). onServiceConnected() 
方法 是 当 活 动 连接 到 服务 时 调用 的 。 当 服务 与 活动 断 开 时 调用 onServiceDisconnected() 7; 1; . 
在 onServiceConnected0) 方 法 中 ， 当 活动 连接 到 服务 时 ， 通 过 使 用 service 参数 的 
getServVice0) 方 法 ， 然 后 将 其 赋 给 serviceBinder 对 和 象 来 获取 服务 的 一 个 实例 。serviceBinder 
对 象 是 一 个 指向 服务 的 引用 ， 可 以 通过 这 一 对 象 访 问 服务 的 所 有 成 员 和 方法 。 这 里 ， 创 建 
了 一 个 URL 数组 并 将 其 直接 赋 给 服务 中 的 公共 成 员 : 
URL[] urls = new URL[] { 
new URL("http://www.amazon.com/somefiles.pdf"), 
new URL("http://www.wrox.com/somefiles.pdf"), 
new URL("http://www.google.com/somefiles.pdf"), 
new URL("http://www.learn2develop.net/somefiles.pdf")]); 
//---assign the URLs to the service through the 
// serviceBinder object--- 
serviceBinder.urls - urls; 


然后 使 用 一 个 Intent 对 象 启动 服务 : 


startService (i); 


在 可 以 局 动 服务 之 前 ， 需 要 将 活动 绑 定 到 服务 。 这 在 Start Service 按钮 的 startservice() 
方法 中 完成 : 
public void startService (View view) { 
i = new Intent(ServicesActivity.this, MyService.class); 
bindService(i, connection, Context.BIND AUTO CREATE); 
} 
bindService() 方 法 使 活动 与 服务 建立 了 连接 。 它 接受 3 个 参数 : 一 个 ment 对 象 、 一 个 
ServiceConnection 对 象 以 及 一 个 用 来 指示 服务 绑 定 方式 的 标志 。 


11.4 理解 线程 


到 目前 为 止 ， 您 已 经 看 到 了 如 何 创建 服务 ， 以 及 为 什么 确保 长 时 间 运 行 的 任务 得 到 恰 
当 的 处 理 是 非常 重要 的 ， 特 别 是 在 更 新 UI 线程 时 。 在 本 章 前 面 (和 第 10 章 ) 看 到 了 如 何 使 
用 AsyncTask 类 在 后 台 执 行 长 时 间 运 行 的 代码 。 本 节 将 简要 总 结 一 下 使 用 各 个 可 用 的 方法 
正确 处 理 长 时 间 运 行 的 任务 的 几 种 方式 。 

这 里 的 讨论 假定 有 一 个 名 为 Threading 的 Android 项 目 。main.xml 文件 中 包含 一 个 
Button 和 一 个 TextView: 


<?xml version-"1.0" encoding-"utí-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
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android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


<TextView 
android: layout width-"fill parent" 
android:layout height="wrap content" 
android: text="@string/hello" /> 


<Button 
android: id="@+id/btnStartCounter" 
android: layout width="match parent" 
android: layout height="wrap content" 
android: text="Start" 
android:onClick="startCounter" /> 


<TextView 
android: id="@+tid/textView1" 
android: layout width="match parent" 
android: layout height="wrap content" 
android: text="TextView" /> 


</LinearLayout> 


假设 想 要 在 活动 中 显示 一 个 从 1 到 1000 fit Bias. TE ThreadingActivity 关中 有 如 下 代码 : 


package net.learn2develop. Threading; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 

import android.view.View; 
import android.widget.TextView; 


public class ThreadingActivity extends Activity [| 
TextView txtViewl; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


txtViewl = (TextView) findViewBylId(R.id.textViewl1) ; 


public void startCounter(View view) { 
for (int i-0; i<=1000; i++) { 
txtViewl.setText(String.valueOf (1)); 
try { 
Thread.sleep(1000); 
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} catch (InterruptedException e) { 
Log.d("Threading", e.getLocalizedMessage()); 
} 


) 


运行 应 用 程序 并 单 击 Start 按钮 时 ， 应 用 程序 将 被 短暂 地 冻结 , 一 段 时 间 后 可 以 看 到 如 
图 11-5 所 示 的 消息 。 


Threading is not responding. 


Would you like to close it? 


Wait OK 


图 11-5 


用 户 界面 之 所 以 会 冻结 ， 是 因为 在 应 用 程序 显示 了 计数 器 的 一 个 值 后 会 暂停 1 秒 钟 ， 
而 与 此 同时 想 让 应 用 程序 不 断 地 显示 计数 器 的 另 一 个 值 。UI 会 等 待 数字 完成 显示 ， 所 以 来 
不 及 处 理 。 结 果 导 致 应 用 程序 不 能 响应 ， 让 用 户 感到 失望。 

为 了 解决 这 个 问题 ， 一 种 方法 是 使 用 一 个 Thread 类 和 一 个 Runnable 类 来 封装 包含 了 
循环 的 代码 部 分 ， 如 下 所 示 : 


public void startCounter (View view) I 
new Thread (new Runnable() I 
public void run() { 
for (int i=0; i<=1000; i++) { 
txtViewl1.setText (String. valueOf (1) ) ; 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
Log.d("Threading", e.getLocalizedMessage()); 
} 
} 
} 
}) .start(); 
} 


在 前 面 的 代码 中 ， 首先 创建 一 个 实现 了 Runnable 接口 的 类 。 利 用 该 类 将 长 时 间 运 行 的 
代码 放 到 run0 方 法 中 。 然 后 ，Runnable 块 开始 使 用 Thread 25. 


注意 : 一 个 Runnable 是 可 被 一 个 线程 执行 的 代 但 块 。 
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但 是 ， 前 面 的 应 用 程序 不 能 工作 ,试图 运行 它 会 使 它 崩 尝 。 放 到 Runnable 块 中 的 代码 
在 一 个 单独 的 线程 上 运行 , 在 前 面 的 示例 中 , 试图 从 另外 一 个 线程 来 更 新 UI. 由 于 Android 
用 户 界 面 不 是 线程 安全 的 ， 所 以 这 么 做 并 不 安全 。 为 了 解决 这 个 问题 ， 需 要 使 用 一 个 View 
的 post0 方 法 来 创建 男 一 个 Runnable0 块 来 添加 到 消息 队列 中 。 简 言 之 , 新 创建 的 Runnable 
块 将 在 UI 线程 中 执行 ， 所 以 现在 执行 应 用 程序 是 安全 的 : 


public void startCounter (View view) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
for (int i=0; i<=1000; i++) { 
final int valueOfi = 1; 


//---update UI--- 
txtViewl.post(new Runnable() { 
public void run() { 
//---UI thread for updating--- 
txtViewl.setText(String.valueOf (valueOf1i)); 


H): 


//---insert a delay 

try { 
Thread.sleep(1000); 

} catch (InterruptedException e) { 
Log.d("Threading", e.getLocalizedMessage()); 

} 

} 
} 
}) .start (); 
} 


现在 应 用 程序 可 以 正确 运行 ， 但 是 其 代码 十 分 复杂 ， 不 易 维护 。 

另外 一 种 在 其 他 线程 中 更 新 UI 的 方法 是 使 用 Handler 2$. Handler 类 允许 发 送 和 处 理 
消 县 ， 惑 像 使 用 一 个 View 的 postO0 方 法 一 样 。 下 面 的 代码 片段 显示 了 一 个 名 为 Ulupdater 的 
Handler 类 ， 它 使 用 接收 到 的 消息 更 新 UL: 


注意 : 需要 导入 android.os.Handler 包 ， 并 向 txtViewl 添加 static 修饰 符 才 能 使 
这 段 代码 工作 。 


//---used for updating the UI on the main activity--- 
static Handler UlIupdater = new Handler() { 
@Override 
public void handleMessage (Message msg) { 
byte[] buffer = (byte[]) msg.obj; 
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//---convert the entire byte array to string--- 
String strReceived - new String(buffer); 


//---display the text received on the TextView--- 
txtViewl.setText(strReceived); 
Log.d("Threading", "running"); 


}; 


public void startCounter (View view) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
for (int i-0; i<=l1000; itt) { 
//---update the main activity UI--- 
ThreadingActivity.Ulupdater.obtainMessage( 
0,String.valueOf(1).getBytes() ).sendToTarget(); 
//---insert a delay 
try { 
Thread.sleep(1000); 
) catch (InterruptedException e) { 
Log.d("Threading", e.getLocalizedMessage()); 


} 
)).start(); 


) 


对 Handler 类 的 详细 讨论 不 在 本 书 的 范围 内 。 更 多 信息 请 查看 位 于 以 下 地 址 的 文档 ; 
http://developer.android.com/reference/android/os/Handler.html . 

刚才 讨论 的 这 两 种 方法 可 以 在 一 个 单独 的 线程 中 更 新 UI。 在 Android 中 ， 可 以 使 用 更 
简单 的 AsyncTask 类 来 实现 相同 的 操作 。 当 使 用 AsyncTask IN}, 按 如 下 所 示 , 重 写 前 面 的 代码 : 


private class DoCountingTask extends AsyncTask<Void, Integer, Void> { 
protected Void doInBackground(Void... params) { 
for (int i = 0; i < 1000; i++) { 
//---report its progress--- 
publishProgress (i); 
try 1 
Thread.sleep(1000); 
} catch (InterruptedException e) { 
Log.d("Threading", e.getLocalizedMessage()); 


} 


return null; 
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protected void onProgressUpdate(Integer... progress) { 
txtViewl.setText(progress[0].toString()); 
Log.d("Threading", "updating..."); 


public void startCounter(View view) { 
new DoCountingTask().execute(); 


} 


前 面 的 代码 将 从 男 一 个 线程 安全 地 更 新 UI. 那么 如 何 停止 任务 呢 ? 如 果 运 行 这 个 应 用 
程序 ， 然 后 单 击 Start 按钮 ， 计 数 器 将 从 0 开始 进行 显示 。 但 是 ， 如 果 按 模拟 占 / 设 备 上 的 
Back 按钮 ， 即 使 活动 已 被 销毁 ， 任 务 也 会 继续 运行 。 通 过 LogCat 窗口 可 以 验证 这 一 点 。 
如 果 想 要 停止 任务 ， 可 以 使 用 下 和 面 的 代码 片段 : 


public class ThreadingActivity extends Activity I 
static TextView txtViewl; 


DoCountingTask task; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedinstanceState) ; 
setContentView (R.layout.main) ; 


txtViewl = (TextView) findViewById(R.id.textViewl); 


public void startCounter (View view) { 
task = (DoCountingTask) new DoCountingTask () .execute() ; 


public void stopCounter (View view) { 
task.cancel (true) ; 


private class DoCountingTask extends AsyncTask<Void, Integer, Void> | 
protected Void dolnBackground (Void... params) { 
for (int i = 0; i < 1000; i++) | 

//———report its progreas-— — 

publishProgress (i); 

try i 
Thread.sleep (1000); 

} catch (InterruptedException e) | 
Log.d("Threading", e.getLocalizedMessage()); 

} 

if (isCancelled()) break; 


AAT 
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return null; 
} 
protected void onProgressUpdate (Integer... progress) { 


txtViewl.setText (progress[0].toString()); 
Log.d("Threading", "updating..."); 


} 
@Override 
protected void onPause() { 


super .onPause() ; 
stopCounter (txtView1); 


} 
为 停止 AsyncTask 子 类 ,首先 需 要 获得 它 的 一 个 实例 。 调 用 任务 的 cancel0 方 法 可 以 停 
止 任 务 。 在 任务 内 ， 调 用 isCancelled0 方 法 来 检查 任务 是 否 应 该 终止 。 


11.5 本草 小 结 


在 本 章 中 , 我 们 学 习 了 如 何在 Android 项 目 中 创建 一 个 服务 来 执行 长 时 间 运 行 的 任务 。 
了 解 了 可 以 用 来 确保 后 台 任 务 以 异步 方式 执行 而 不 阻塞 主 调 活 动 的 许多 方法 。 我 们 还 学 习 
了 活动 是 如 何 给 服务 传递 数据 的 ,以 及 如 何 绑 定 到 一 个 活动 , 使 之 可 以 更 直接 地 访问 服务 。 


1. 为 什么 说 将 一 个 服务 中 的 长 时 间 运 行 的 代码 放 在 一 个 单独 的 线程 中 是 重要 的 ? 
2. IntentService 类 的 作用 是 什么 ? 

3. 说 出 需要 在 一 个 AsyncTask 类 中 实现 的 3 个 方法 。 

4. 服务 如 何 通 知 活动 发 生 了 一 个 事件 ? 

S. 对 于 线程 ， 推 荐 用 哪 种 方法 来 确保 代码 在 运行 时 不 会 阻塞 应 用 程序 的 UI? 
练习 答案 参见 附录 C. 


本 章 主 要 内 容 
E a 关键 概念 
创建 一 个 服务 创建 一 个 类 并 扩展 Service 类 
在 一 个 服务 中 实现 方法 实现 以 下 方法 : onBind0、onStartCommandO 和 onDestroy() 
局 动 一 个 服务 使 用 startService077 3; 
停止 一 个 服务 使 用 stopService0 方 法 


使 用 AsyncTask 类 并 实现 3 个 方法 : dolnBackground() ~ 
onProgressUpdate() 和 onPostExecute() 
执行 重复 的 任务 使 用 Timer 类 并 调用 它 的 scheduleAtFixedRate0 方 法 


执行 长 时 间 运 行 的 任务 
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( 续 表 ) 
+ ”是 关键 概念 
在 一 个 单独 的 线程 中 执行 任务 


更 用 IntentService 类 
并 自动 停止 一 个 服务 — 


Ti FH Intent 对 和 象 给 服务 传递 数据 。 对 于 一 个 服务 ,广播 一 个 Intent 
来 通知 一 个 活动 

将 活动 绑 定 到 服务 在 服务 中 使 用 Binder 类 并 在 主 调 活动 中 实现 ServiceConnection 类 
使 用 视图 的 post0 方 法 来 更 新 UI。 或 者 ， 可 以 使 用 Handler 25. jf 
看 的 方法 是 使 用 AsyncTask 类 


在 活动 和 服务 之 间 通 信 


在 一 个 Runnable 块 中 更 新 UI 
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发 布 Android 应 用 程序 


本 章 将 介绍 以 下 内 容 : 

e 如 何 为 部 署 应 用 程序 做 准备 

e 如 何 将 应 用 程序 导出 为 一 个 APK 文件 并 用 新 的 证 书 对 其 签名 
e 如 何 分 发 Android 应 用 程序 

e 如 何在 Android Market 上 发 布 应 用 程序 


到 目前 为 止 ， 您 已 经 了 解 到 了 使 用 Android 可 以 做 很 多 有 趣 的 事情 。 然 而 ， 为 了 使 您 
的 应 用 程序 可 以 在 用 户 的 设备 上 运行 ， 需 要 一 个 方法 来 部 羞 和 分 发 它 。 在 本 章 中， 将 学 习 
如 何 为 部 署 Android 应 用 程序 做 准备 并 将 它们 转移 到 客户 设备 上 。 此 外 ， 还 将 学 习 如 何 将 
您 的 应 用 程序 发 布 到 Android Market 上 ， 在 那里 您 可 以 通过 出 售 应 用 程序 来 赚钱 ! 


12.1 为 发 布 做 准备 


Google 已 经 使 得 Android 应 用 程序 的 发 布 变 得 相当 容易 ， 因 此 可 以 很 迅速 地 将 其 分 发 
给 终端 用 户 。 发 布 Android 应 用 程序 的 步骤 通常 包含 以 下 几 步 : 

(1) 将 应 用 程序 导出 为 一 个 APK(Android Package) 文 件 。 

(2) 生成 目 己 的 目 签名 证 书 并 用 它 对 应 用 程序 进行 数学 签名 。 

(3) 部 署 签名 后 的 应 用 程序 。 

(4) 利用 Android Market 对 应 用 程序 进行 托管 和 出 售 。 

在 接 下 来 的 小 节 中 ， 将 学 习 如 何 为 签署 应 用 程序 做 准备 ， 以 及 学 习 部 署 应 用 程序 的 不 
同方 法 。 

本 章 中 将 使 用 在 第 9 章 创建 的 LBS 项 目 来 说 明 如 何 部 署 Android 应 用 程序 。 


12.1.1 版 本 化 


从 Android SDK 1.0 版 本 开始 ， 每 一 个 Android 应 用 程序 的 AndroidManifest.xml 文件 


452 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


都 包括 了 android:versionCode 和 android:versionName 属性 : 


<?xml version-"1.0" encoding="utf-8"?> 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="net.learn2develop. LBs" 
android: versionCode="1" 
android: versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /» 

«uses-permission android:name="android.permission. INTERNET"/> 

«uses-permission android: name="android.permission.ACCESS FINE 
LOCATION" /> 

«uses-permission android:name="android.permission.ACCESS COARSE _ 
LOCATION" /> 


<application 
android:icon="@drawable/ic launcher" 
android:label="@string/app name" > 
«uses-library android:name-"com.google.android.maps" /> 
«activity 
android: label="@string/app name" 
android:name=".LBSActivity™ > 
<intent-filter > 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category. 
LAUNCHER" /> 
«/intent-filter» 
«/activity» 
</application> 


</manifest> 


android:versionCode 属性 表示 了 应 用 程序 的 版 本 号 。 对 于 对 应 用 程序 所 做 的 每 一 次 修 
改 ， 都 应 该 将 这 个 值 加 1， 以 便 可 以 以 编程 方式 来 区 分 先前 版 本 和 最 新 版 本 。Android 系统 
永远 不 会 使 用 这 个 值 。 但 对 于 开发 人 员 来 说 ， 这 是 一 个 获得 应 用 程序 版 本 号 的 很 有 用 的 方 
法 。 不 过 ，Android Market 使 用 android:versionCode 属性 来 确定 应 用 程序 是 否 有 新 的 版 本 
可 用 。 

可 以 使 用 PackageManager 类 的 getPackageInfo0 方 法 以 编程 方式 检索 android:versionCode 
属性 的 值 ， 如 下 所 示 : 

import android.content.pm.PackageInfo; 


import android.content.pm.PackageManager; 
import android.content.pm.PackageManager.NameNotFoundException; 


private void checkVersion() { 
PackageManager pm = getPackageManager(); 
try | 
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/f/--—-9eC the package info--- 

PackageInfo pi = 
pm.getPackageInfo("net.learn2develop.LBS", 0); 

//---display the versioncode--- 

Toast.makeText (getBaseContext(), 
"VersionCode: " +Integer.toString (p1.versionCode), 
Toast.LENGTH SHORT).show(); 

} catch (NameNotFoundException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


} 


android:versionName 属性 包含 了 对 用 户 可 见 的 版 本 信息 。 它 应 该 以 <major>.<minor>. 
<point> 格 式 包含 值 。 如 果 应 用 程序 进行 了 重要 的 升级 ， 那 么 应 该 将 <major> 加 1。 对 于 微小 
的 增 量 更 新 ， 可 以 将 <minor> 或 <poin 人 加 1。 例 如 ， 一 个 新 的 应 用 程序 的 版 本 名 称 是 1.0.0. 
对 于 较 小 的 增 量 更 新 ， 可 以 将 版 本 名 称 修 改 为 1.1.0 或 1.0.1。 如 果 下 一 次 有 较 大 的 更 新 ， 
可 以 将 其 变 为 2.0.0。 

如 果 计 划 在 Android Market(www.android.com/market 站 上 发 布 应 用 程序 ，AndroidMani- 
fest.xml 文件 必须 具有 以 下 属性 : 

e android:versionCode (位 于 <manifest> 元 素 中 ) 

e android:versionName (位 于 <manifest> 元 素 中 ) 

e android:icon (位 于 <application> 元 素 中 ) 

e android:label (位 于 <application> 元 素 中 ) 

android:label 属性 指定 了 应 用 程序 的 名 称 。 这 个 名 称 将 显示 在 Android 设备 的 Settings | 
Apps 部 分 中 。 对 于 LBS 项 目 ， 我 们 给 应 用 程序 起 名 为 Where Am I: 

<?xml version-"1.0" encoding="uti-8"?> 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 

package="net.learn2develop. LBs" 


android:versionCode="1" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="14" /> 

«uses-permission android:name="android.permission. INTERNET"/> 

«uses-permission android: name="android.permission.ACCESS FINE 
LOCATION" /> 

«uses-permission android:name-"android.permission.ACCESS COARSE _ 
LOCATION" /> 


<application 
android:icon="@drawable/ic launcher" 
android:label="Where Am I" > 
«uses-library android:name-"com.google.android.maps" /> 
«activity 
android: label="@string/app name" 
android:name=".LBSActivity" > 
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<intent-filter > 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category. 
LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 


</manifest> 


另外 ， 如 果 运 行 应 用 程序 需要 一 个 最 低 版 本 的 Android 操作 系统 ， 那 么 可 以 在 
AndroidManifest.xml 文件 中 使 用 <uses-sdk> 元 素来 指定 : 


<?xml version-"1.0" encoding-"utfí-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"net.learn2develop.LBS" 
android:versionCode-"1" 
android:versionName="1.0" > 


«uses-sdk android:minSdkVersion="13" /> 

«uses-permission android:name="android.permission. INTERNET"/> 

«uses-permission android: name="android.permission.ACCESS FINE | 
LOCATION" /> 

«uses-permission android: name="android.permission.ACCESS COARSE _ 
LOCATION" /> 


<application 
android:icon="@drawable/ic launcher" 
android:label-"Where Am I" > 
«uses-library android:name-"com.google.android.maps" /» 
«activity 
android: label="@string/app name" 
android:name-".LBSActivity" > 
«intent-filter > 
<action android:name="android.intent.action.MAIN" /> 


«category android: name="android.intent.category.LAUNCHER"/> 
«/intent-filter» 
<factivity> 
</application> 


</manifest> 


在 前 面 的 示例 中 ， 应 用 程序 需要 的 最 低 SDK 版 本 为 13， 即 Android 3.2.1。 一 般 来 说 ， 
将 这 个 版 本 号 设置 为 应 用 程序 可 支持 的 最 低 版 本 是 明智 的 。 这 可 以 保证 有 更 广泛 的 用 户 可 
以 运行 您 的 应 用 程序 。 


12.1.2 对 Android 应 用 程序 进行 数字 签名 
所 有 Android 应 用 程序 在 被 允许 部 署 到 设备 (或 模拟 器 ) 上 之 前 必须 经 过 数字 签名 。 与 
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一 些 手 机 平台 不 同 ， 您 不 需要 从 认证 机 构 (CA) 购 买 数 学 证 书 来 进行 签名 。 相 反 ， 您 可 以 生 
成 自己 的 自 签 名 证 书 并 用 它 为 Android 应 用 程序 签名 。 

如 果 使 用 Eclipse 开发 Android 应 用 程序 ， 然 后 按 F11 键 将 其 部 车 到 一 个 模拟 右上 ， 
Eclipse 将 目 动 为 您 对 其 进行 签名 。 可 以 在 Eclipse 中 选择 Window | Preferences, 展开 Android 
项 ， 选 择 Build( 如 图 12-1 所 示 ) 来 验证 这 一 点 。Eclipse 使 用 一 个 默认 的 调试 密 钥 库 (被 命名 
为 debug.keystore) 来 对 应 用 程序 签名 。 密 钥 库 种 被 称 为 数字 证 书 。 


| type filter text 


^ General 


É | Build Settings: 
4 Android ES i . 
Build | | Automatically refresh Resources and Assets folder on build 
DDMS | Force error when external jars contain native libraries 
Editors | Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch Build output 
LogCat @ Silent 

Usage 5tats 

> Ant 
» Data Management E 


> Help Default debug keystore — C:\Users\Wei-Meng Lee\.android\ debug. keystore 
» Install/Update 


» Java Custom debug keystore: 
» Java EE 
^» Java Persistence 


b JavaScnpt Restore Defaults Apply 
» Mylyn 


5 Normal 
(^3 Verbose 


图 12-1 


如 果 您 正在 发 布 一 个 Android 应 用 程序 ， 就 必须 使 用 您 自己 的 证 书 来 对 其 进行 签名 。 
使 用 调试 证 书签 名 的 应 用 程序 是 不 能 被 发 布 的 。 虽 然 您 可 以 使 用 Java SDK 提供 的 
keytool.exe 实用 程序 来 手动 生成 目 己 的 证 书 , 但 Eclipse 通过 提供 一 个 向 导 使 这 一 过 程 变 得 
更 容易 了 ， 它 可 以 引导 您 一 步 步 地 生成 证 书 。 它 将 使 用 生成 的 证 书 对 应 用 程序 进行 签名 (也 
可 以 使 用 Java SDK 的 jarsigner.exe 工具 进行 手动 签名 )。 

下 面 的 “ 试 一 试 ” 展 示 了 如 何 使 用 Eclipse 导出 一 个 Android 应 用 程序 并 使 用 新 生成 的 
证 书 进行 签名 。 
导出 Android 应 用 程序 并 对 其 签名 

在 这 个 “ 试 一 试 ” 中 ， 将 使 用 第 9 章 创 建 的 LBS 项 目 。 

(1) 在 Eclipse 中 选择 LBS 项 目 并 选择 File | Export.... 

(2) 在 Export 对 话 框 中 , 展开 Android 项 , 并 选择 Export Android Application( 如 图 12-2 
所 示 )， 单 击 Next 按钮 。 

(3) 现在 LBS 项 目 应 该 显示 出 来 了 (如 图 12-3 所 示 )， 单 击 Next 按钮 。 

(4) 选择 Create new keystore 选项 来 创建 一 个 新 的 证 书 ( 密 钥 库 ) 用 于 应 用 程序 签名 (如 
图 12-4 所 示 )。 输 入 保存 新 密 钥 库 的 路 径 并 输入 一 个 密码 来 保护 此 密 钥 库 。 在 本 例 中 ， 输 
入 keystorepassword {7 42474, Ad Next 按钮 。 
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WB) Export Android Application 


Project Checks 


Performs a set of checks to make sure the application can be exported. 


Select Ehe project to export: 


Select an export destination: 


| type filter text Project: LBS 


p G General Mo errors found. Click Mext. 
4 (> Android 

|i: Export Android Application 
t ta EB 


» E Install 

f [£3 Java 

b Ge Java EE 

t E Plug-in Development 
> > Remote Systems 
> (=> Run/Debug 

> > Tasks 

- (=> Team 

b > Web 

b [m Web Serulces 

h or. WAAL 


Cancel 


图 12-2 图 12-3 


(5) 为 私 钥 提供 一 个 别名 (命名 为 IER 
DistributionKeyStoreAlias, 如 图 12-5 所 示 ) MN 
并 输入 一 个 密码 来 保护 私 钥 。 在 本 例 中 ， m 
tA keypassword 作为 密码 。 还 需要 输入 |e, cmo 
密 钥 的 有 效 期 。 根据 Google 的 规定 , 您 的 BUE aE 
应 用 程序 必须 用 一 个 加 密 的 私 钥 进行 签 
名 ， 其 有 效 期 要 到 2033 年 10 月 22 日 以 
后 才能 结束 。 因 此 ， 应 该 输入 一 个 大 于 
2033 减 去 当前 年 份 的 数 。. 最 后 ,在 First and 
Last Name 字段 中 输入 自己 的 姓名 。 单 击 
Next TZ dl. 

(6) 输入 存储 APK 目标 文件 的 路 径 (如 图 12-4 
图 12-6 所 示 )。 单 击 Finish 按钮 ， 将 生成 APK 文件 。 


i] Export Android Application 


B) Export Android Application 
Destination and key/certificate checks 


Destination APE file | C Userz Wei-Ndeng LeeDesktopLBS.apk 


Certificate expires in 3 years. 
Confirm: 
Validity (years: 


First and Last Marne: VWiei-Meng Lee 


| < Back | Hert = | Cancel | 


12-6 
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(7) 在 第 9 章 中 , LBS 应 用 程序 需要 使 用 Google Maps API 2559]. 3x 4 25 


钥 是 通过 使 用 


您 的 debug.keystore 的 MDS 指纹 申请 到 的 。 这 意味 着 Google Maps API 密 钥 与 用 来 对 应 用 


程序 进行 签名 的 debug.keystore 是 捆绑 在 一 起 的 。 因 为 您 现在 生成 了 新 的 密 


: 钥 库 来 对 应 用 


程序 进行 签 mee 部 署 ,所 以 需要 使 用 新 密 钥 库 的 MD5 指纹 再 次 申请 Google Maps API 2:9]. 
要 做 到 这 一 点 , 在 命令 提示 符 窗口 中 输入 以 下 命令 (keytool.exe 实用 程序 的 位 置 可 能 略微 不 
同 ， 如 图 12-7 Pray): 


EN C:\Windows\system32\cmd.exe 


L: Program Files\Java“Jreb\hin2keytool.exe —list -alias DistributionKeystoreAlia 
= -keystore "C:\Users\Wei-Meng Lee*«Desktop*MuMeuCert.keustore'" -storepass keysto 
‘epassword pee ke ypassword -u 
ilias name: Distr ibut ionKe ySt orefA lias 
areation date: Nov 28. 2611 
ntry type: PrivateKeyEntry 
Certificate chain length: 1 
Certificatelil: 
Owner: GH-Uei-Meng Lee 
Issuer: CH-Mei-Meny Lee 
serial number: 4ed3i/18f 
alid from: Mon Mov 28 1?: 43:35 SGI 2611 until: Wed Mou 26 19:33:35 S61 24641 
Certificate fingerprints 
MDS C2:B8A: 5C: TTE 55:4B:60:34:D0C:86 :DE:80:26:7E:0F:1i2 
SHAL : 86 :58:9F:38:6C:08:20:C7:BC:B5:01:88:8B:00 :7B: 4C: 88 : FD: 0C: 6f 
Signature algorithm name: SHALWiathRSA 
Uersion: 3 


«Program Files^4aua*jre&b*hin:? 


图 12-7 


C:\Program Files\Java\jre6\bin>keytool.exe -list -v -alias 
DistributionKeyStoreAlias 

-keystore "C:\Users\Wei-Meng Lee\Desktop\MyNewCert.keystore" 
-storepass keystorepassword -keypass keypassword -v 


(8) 使 用 从 前 面 的 步骤 获得 的 MDS 指纹 ， 转 到 http://code.google.com/android/add- 


ons/google-apis/maps-api-signup.html 并 注册 一 个 新 的 Maps API 2E]. 
(9) 在 main.xml 文件 中 输入 新 的 Maps API 密 钥 : 


<?xml version-"1.0" encoding-"utfí-8"?» 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«com.google.android.maps.MapView 
android:id="@+id/mapView" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:enabled-"true" 
android:clickable-"true" 
android:apiKey-"your key here" /» 


</LinearLayout> 


(10) 由 于 在 main.xml 文件 中 输入 了 新 的 Maps API 密 钥 ， 现 在 需要 您 再 


URE tH DA 
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keystore 选项 (如 图 12-8 所 示 ) 并 输入 一 个 先前 用 于 保护 您 的 密 钥 库 的 密码 (在 这 里 ， 密 码 是 
keystorepassword)。 单 击 Next 按钮。 


(11) 选择 Use existing key 选项 (如 图 12-9 所 示 ) 并 输入 先前 设置 的 用 于 保护 私 钥 的 密码 


(输入 keypassword). itt Next 按钮 。 
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rH Export Android Application — 


Keystore selection 


ub Export Android Application 


Key alias selection 


i& Use exishng key 


Alias: | distributionkeystorealias m 


Password: 0286086008 | 


i& Use exishng keystore 
(D Create new keystore 
Location: CA Useri We- Meng Lee\ Desktop MyNewCert.keystore 
Create new key 


Password: #29698 seeteesene 


Confirms: 


merum mr rum ah) a 


图 12-8 12-9 


(12) 单 击 Finish 按钮 (如 图 12-10 所 示 ) 再 次 生成 APK 文件 。 
到 此 为 止 ，APK 已 经 生成 了 ， 它 包含 了 捆绑 到 新 密 钥 库 的 新 的 Maps API 密 钥 。 
IÆ} Export Android Application ia | 


Destination and key/certificate checks 


E Destination file already exists. 


Certificate expires on Wed Nov 20 19:33:35 SGT 2041. 
: WARNING: destination file already exists 
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Eclipse 提供 了 Export Android Application 选项 ， 可 以 帮助 您 将 Android 应 用 程序 导出 
为 一 个 APK 文件 并 生成 一 个 用 于 对 APK 文件 进行 签名 的 新 的 密 钥 库 。 对 于 使 用 Maps API 
的 应 用 程序 ， 要 注意 Maps API 密 钥 必须 和 为 您 的 APK 文件 签名 的 新 密 钥 库 相 关联 。 


12.2 部署 APK 文件 


-日 对 APK 文件 进行 了 签名 ， 就 需要 有 个 方法 将 它们 转移 到 用 户 设备 上 。 下 面 的 小 
节 将 描述 部 署 APK ACER LS, 主要 包括 以 下 3 个 方法 : 
e 使 用 adb.exe 工具 手动 部 省 
e 在 Web 服务 器 上 托管 应 用 程序 
e 通过 Android Market 发 布 
除了 以 上 方法 ， 还 可 以 通过 电子 邮件 、SD 卡 等 方式 将 您 的 应 用 程序 安装 到 用 户 设备 
上 。 只 要 能 将 APK 文件 转移 到 用 户 设备 上 ， 您 就 能 够 安装 这 些 应 用 程序 。 


12.2.1 使 用 adb.exe 工具 


“A Android 应 用 程序 经 过 签名 ， 就 可 以 使 用 abd.exe(Android Debug Bridge) 工 具 ( 位 

+ Android SDK 的 platform-tools 文件 夹 中 ) 将 其 部 署 到 模拟 右 和 设备 上 。 
使 用 Windows 中 的 命令 提示 符 ， 转 到 <Android SDK>\platform-tools 文件 夹 下 。 要 在 
模拟 器/ 设备 上 安装 应 用 程序 (假设 模拟 器 当前 已 经 启动 并 运行 或 设备 已 连接 )， 可 输入 以 下 


me 
命令 : 


adb install "C:\Users\Wei-Meng Lee\Desktop\LBS.apk" 


adb.exe 工具 介绍 
adb.exe 工具 是 一 个 多 功能 的 工具 , 可 以 用 来 控制 与 您 的 计算 机 相连 的 Android 设备 (和 
模拟 器 )。 
默认 情况 下 ， 当 使 用 adb 命令 时 ， 假 定 当前 只 连接 了 一 台 设 备 / 模 拟 器 。 如 果 连 接 了 多 
台 设 备 ， 那 么 adb 命令 会 返回 一 个 错误 消息 : 


error: more than one device and emulator 


可 以 使 用 adb 的 devices 选项 来 查看 当前 连接 到 计算 机 上 的 设备 ， 如 下 所 示 : 


D:\Android 4.0\android-sdk-windows\platform-tools>adb devices 
List of devices attached 

HTO 7YPYOB 335 device 

emulator-5554 device 

emulator-5556 device 
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正如 上 面 的 示例 所 显示 的 ， 这 个 命令 返回 一 个 当前 已 连接 设备 的 列表 。 为 了 给 一 个 特 
定 的 设备 发 出 命令 ， 需 要 使 用 -s 选项 来 指明 此 设备 ， 如 下 所 示 : 

adb -s emulator-5556 install LBS.apk 

如 果 试 图 在 一 台 已 有 APK 文件 的 设备 上 安装 该 文件 ， MERE TERNA: 

Failure [INSTALL FAILED ALREADY EXISTS] 

如 果 先 前 的 LBS DL REAP DSA EV eat, By Liat Settings | Apps | LBS | 
Uninstall 来 删除 它 。 


有 时 候 ADB 会 失败 ( 当 同 时 打开 了 过 多 的 ADV 时 ， 您 会 注意 到 无 法 再 把 应 用 程序 从 
Eclipse 部 署 到 真实 的 设备 或 者 模拟 器 上 )。 此 时 ， 需 要 关闭 服务 器 并 重 局 它 : 


adb kill-server 


adb start-server 


如 果 查 看 Android 设备 /模拟 器 上 的 Launcher， 可 以 看 到 


F 
E Mandai AD. Wih Maps 


LBS 图 标 ( 在 图 12-11 的 项 部 )。 如 果 在 Android 设备 /模拟 器 ELSE 
上 选 择 S ettings | Apps: 将 可 以 看 到 Where Am I 应 用 程序 (在 DOWNLOADED ON SD CARD RUNNING 


^um COM. dnarord. gesture. punder 
LA ZB. DUKE 


图 12-11 的 底部 )。 
adb exe pio dium nag ene S omne 

移 除 已 安装 的 应 用 程序 。 要 做 到 这 一 点 ， 可 以 使 用 uninstall ives 

选项 将 一 个 应 用 程序 从 其 安装 文件 夹 nn ae 


adb uninstall net.learn2develop.LBS 


部 普 应 用 程序 的 另外 一 种 方法 是 使 用 Eclipse 中 的 
DDMS 工具 (如 图 12-12 所 示 )。 选 择 一 个 模拟 器 (或 设备 ) 后 ， 
使 用 DDMS 中 的 File Explorer 进入 到 /data/app 文件 夹 并 通过 
Push a file onto the device 按钮 将 APK 文件 复制 到 设备 上 。 


il OOA - LES/res lyeutimain em - Eclipse 5 |E micum 
File Edā Run  Mavigate Search Propect Refactor Window Help 


ns Bar 人 = :四 过 = E E ava BF Debug [S DOMS |7% Java EE 
E - "s = pe E 
gl Devices H = 0| $ Threads | @ Heap 国 Allocation Tracker | File Explorer. 2 "CB 
at Harma Soe Date Taj Ducis e ERE ha —À 
Mame = || a > data di-l- WW:  drenmwu--x m 
B ernulgtor-5554 Online L=> anr 2011-11-20  D1:58 — drwerwxr-x 
iysbem peace Br : - k app SL l1 22 12:07 ë darea x 
com andred. athena i4 [ c Apiemosapk M33 MlA- ALAS -ra E 
mandroid. inputmethodlat 154 cb CubeLiveWallpapenapk 1535 Midd? 2148 rrr 
com.android.phome 157 T GestureBuilder.apk 27670 Adl1-d0-12 X48 — -mw-r—r-- c 
—c—ÉAEE EM 10 Cb Softheyboard.apk 34348 L-10- 2130 — -rw-r-—r-- c 
tom.geagle process gapps 3 C WidgetPrevsew.apk A WMI- 2138 — -re-r--r-- € 
tam.andreid. settings £L k= app-prnate NIEl-l1-ll O29 — de.wnax--3 
android. process.ace one 250 (= backup mui-di-zb 1240 dre 
m.android.calenda zn (= dalvik-cache ii-i- 1205 — drwernwx--x 
m.andreid.deskelock ET: LS data JMl1-11-28 12305 —dreemax--x 
B dentpanic L-11- 02065 — drwar-x-— 
= erem 01-11-11. NAMA irama- 
E Emulace Control H = || Oe local ALi- 0208 drania 
Telephory Status ^ EE boste found AMuüi-di-bi 0306 draamas 
Unite homa 00 reed | ald - 
= cole ii > E| = Brn 
DDMS 
CL L Liv TT 
t d.d b.AdbHelpner teRemat di AdbHelper.j 
1.4 H ey hel fia 
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12.2.2 ”使 用 Web 服务 器 


如 果 和 希望 自己 驻 留 应 用 程序 ， 可 以 使 用 一 台 Web 服务 器 来 完成 。 如 果 您 有 自己 的 Web 
托管 服务 并 且 打 算 为 您 的 用 户 免 费 提供 应 用 程序 (或 者 将 访问 限制 为 特定 用 户 群 )， 这 是 个 
不 错 的 选择 。 


O XE ETÀ APK 文件 后 ， 即 使 您 将 对 应 用 程序 的 访问 权限 限制 为 菜 个 
特定 的 用 户 群 ， 也 还 是 没有 什么 能 阻止 这 些 用 户 将 您 的 应 用 程序 重新 分 发 
给 其 他 用 户 。 


为 了 说 明 这 一 点 ， 作 者 将 使 用 Windows 7 计算 机 上 的 IIS(Internet Information Server), 
将 已 签名 的 LBS.apk 文件 复制 到 ci\inetpub\Wwwwroot\。 男 外 ， 创 建 一 个 新 的 名 为 index.html 
的 HTML 文件 ， 其 内 容 如 下 : 

<html> 

<title>Where Am I application</title> 

<body> 

Download the Where Am I application <a href="LBS.apk">here</a> 

</body> 

</html> 


注意 ， 如 果 不 清楚 如 何在 Windows 7 计算 机 上 设置 IIS， 可 查阅 以 下 链接 : 
http://technet.microsoft.com/en-us/library/cc725762.aspx. 


在 您 的 Web IRS ss E. 83279 APK 文件 注册 一 个 新 的 MIME KA. apk 扩展 名 对 应 
的 MIME 类 型 是 application/vnd.android.package-archive. 


注意 : 如 果 不 知道 如 何在 JIS 中 设置 MIME 类 型 ， 可 查阅 以 下 链接 : 
http://technet.microsoft.com/en-us/library/cc725608(WS.10).aspx. 


注意 : 要 在 Web 上 安装 APK 文件 ， 需 要 在 您 的 模拟 器 或 设备 上 安装 一 个 SD 
卡 。 这 是 由 于 下 载 的 APK 文件 将 保存 在 SD £44 download 文件 夹 下 。 为 了 在 
模拟 器 中 对 此 进行 测试 ， 确 保 SD 卡 至 少 有 128MB。 有 报道 称 ， 一 些 开发 人 
员 在 小 于 128MB 的 SD 卡 安 装 应 用 程序 时 遇 到 了 问题 。 


默认 情况 下 ， 对 于 在 线 安装 Android 应 用 程序 ，Android 模拟 器 或 设备 只 允许 安装 来 自 
Android Market(www.android.com/market/) HI v. HH ££ Fr « 因此, 对 于 在 Web 服务 器 上 的 安装 ， 
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需要 配置 您 的 Android 模拟 需 / 设 备 以 接受 来 目 非 Android Market 源 的 应 用 程序 。 

在 Settings 菜单 中 ， 选 中 Security 项 ， 并 滚动 到 屏幕 的 底部 。 选 中 Unknown sources 项 
(如 图 12-13 所 示 )， 会 出 现 一 个 警告 消息 ， 单 击 OK 按钮 。 选 中 这 一 项 将 允许 模拟 器 /设备 
安装 来 目 非 Android Market 源 的 应 用 程序 (例如 来 目 一 台 Web 服务 器 )。 

为 了 从 运行 在 您 计算 机 上 的 IIS Web 服务 器 上 安装 LBS.apk 应 用 程序 ， 可 在 Android 
模拟 器 /设备 上 启动 Browser 应 用 程序 ， 并 导航 到 指 问 APK 文件 的 URL. " 了 指 问 运行 模 
拟 器 的 计算 机 , 应 该 使 用 计算 机 的 卫 地址 .图 12-14 展示 了 Web 浏览 器 上 加 载 的 index.html 
文件 。 单 击 here 链接 将 会 把 APK 文件 下 载 到 您 的 设备 上 。 单 击 屏幕 顶部 的 状态 栏 可 以 显 
示 下 载 的 状态 。 


F 
fa 555A ndraid 4.0, WithMap: n) YMAndid A0 WithMaps 


*. Security 


Download the Where Am | application 
here 


Make passwords visible 


DEVICE ADMINISTRATION 


Device administrators 
View or deactivate device administrators 


Unknown sources 
Allow installation of non-Market 
a p p hz 


"i 


CREDENTIAL STORAGE 


Trusted Ta 
Display trusted ertificates 


Install from SD card 
Install certificates from SD card 


图 12-13 图 12-14 


为 了 安装 下 载 的 应 用 程序 ， 只 要 轻 轻 地 单 击 应 用 程序 ， 将 显示 出 该 应 用 程序 所 需要 的 
权限 。 单 击 Install 按钮 继续 安装 。 当 应 用 程序 安装 完毕 ， 可 以 单 击 Open 按钮 来 启动 它 。 

除了 使 用 Web 服务 器 ， 还 可 以 用 电子 邮件 将 应 用 程序 作为 附件 发 给 用 户 。 当 用 户 收 到 
邮件 时 ， 他 们 可 以 下 载 附件 并 在 目 己 的 设备 上 直接 安装 。 


12.2.3 在 Android Market 上 发 布 


到 目前 为 上 上， 您 已 经 学 习 了 如 何 打包 Android 应 用 程序 以 及 分 发 应 用 程序 所 能 使 用 的 
多 种 方法 一 一 通过 Web 服务 器 、adb.exe 文件 、 电 子 邮 件 、SD 卡 等 。 

然而 ， 这 些 方 法 不 能 为 用 户 提 供 一 个 可 以 很 容易 地 发 现 您 的 应 用 程序 的 途径。 更 好 的 
方法 是 由 Android Market 托管 您 的 应 用 程序 ， 这 是 一 个 可 以 使 用 户 为 其 Android 设备 发 现 
和 下 载 (购买 ) 应 用 程序 变 得 非常 容易 的 由 Google 托管 的 服务 。 用 户 只 需要 在 他 们 的 Android 
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设备 上 局 动 Market 应 用 程序 ， 就 能 够 上 友 现 可 以 在 他 们 设备 上 进行 安 闭 的 各 种 应 用 程序 。 
在 本 节 中 ， 将 学 习 到 如 何在 Android Market 上 发 布 Android 应 用 程序 。 我 将 一 步 步 地 
引导 您 完成 发 布 ， 包 括 在 提交 给 Android Market 前 应 用 程序 所 需要 做 的 各 项 准备 。 


1. 创建 一 个 开发 者 简介 
TE Android Market 上 发 布 应 用 程序 的 第 一 步 是 在 http://market.android.com/publish/Home 上 


创建 一 个 开发 者 简介 。 这 需要 一 个 Google 账户 (例如 您 的 Gmail Wk P). 一 旦 登录 进 Android 
Market， 首 先 创建 开发 者 简介 (如 图 12-15 所 示 )。 在 输入 所 要 求 的 信息 后 单 击 Continue. 


| © ln 
d ii Developer Signup 


lé > QU |O marketandroid.com/publish/signup 


CI 22012 


2 market 


Getting Started 


| 
Before you can publish sofware on tha Android Market, you must da three things: 


+ Create a deve 
* Pay 
+ Agree tothe 


Listing Details 


Your devalaper profile will dabermin 


Developer Hama 


Email Address 


Website URL 


developer profile 
a registration fee (325.00) with your credit card (using Google Checkout) 
Android Market Developer Distribution Agraament 


e how you appear in customers in the Android Markat 


Developer Learning Solutid 


Will appear tp users under tha name of your application 


wa mengleektgmail cam | 


http://Awww.leam2dewelog. 


Phone Humber 
Include plus sign, country code and area code. For example, 4 1-550-253-0000. why do we ask far this? 


Email Updates Gonlact me occasionally about development and Market opportuniias 


Continue w 


ement - Google Terms of Semice - Privacy Policy 
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为 了 在 Android Market 上 发 布 应 用 程序 ,需要 文 付 一 次 性 的 注册 费用 , 目前 是 25 美元 。 
Hi Google Checkout 按钮 会 被 重 定 向 到 一 个 可 以 文 付 注册 费用 的 页 面 。 付 费 之 后 ， 单 击 
Continue 链接 。 

接 下 来 ， 需 要 同意 Android Market Developer Distribution Agreement, X I agree 复 选 
杠 并 单 击 I agree. Continue 链接 。 

2. 提交 应 用 程序 

- 旦 设置 好 简介 后 ， 就 要 准备 向 Android Market 提交 应 用 程序 了 。 如 果 您 的 应 用 程序 
打算 收费 ， 单 击 位 于 屏幕 底部 的 Setup Merchant Account 链接 。 在 这 里 输入 诸如 银行 账号 、 
税 号 等 额外 信息 。 

对 于 免费 的 应 用 程序 ， 单 击 Upload Application 链接 ， 如 图 12-16 所 示 。 
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- Dewaloper roninlü 


€ — QC CQ marketandroid.com,publisi/Home i 3 


L3 
anoso weimengleedgsail.com | Home | Help | Andraid.com | Sign out 


E market 


Your Registration to the Android Market is approved! 
You can now upload and publish eottware to ihe Android Market. 


Developer Learning Solutions 
wermengiendg grad. com 
EX profil a 


All Android Market listings 


No applications uploaded 


a Upload Application 


Development phones 
As a registered developer, you can purchase an unlocked 


Google checkout * 


Want po sell applications im the Android Mamet? 

Sat up a Merchant account with Google Checkout! Yos sil 
need to TEM additional information like your bank account 
1 and Tax ID 

setup DoR Account s 
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将 会 要 求 您 输入 一 些 关 于 应 用 程序 的 详细 信息 。 图 12-17 展示 了 需要 您 提供 的 
第 一 组 详细 信息 。 在 所 需 的 信息 中 ， 必 须 提供 的 包括 : 
e APK 格式 的 应 用 程序 。 
e 至少 两 个 屏幕 快照 。 可 以 使 用 Eclipse 中 的 DDMS 透视 图 来 捕获 应 用 程序 在 模拟 喜 
ca eaten 
e 需要 提供 一 个 高 分 辩 率 的 应 用 程序 图 标 。 图 像 大 小 必须 是 512X512 像素 。 
RENTE 可 以 以 后 再 提供 。 


ans2o13 weimaengleegmail.com | Home | Help | Andraid.com | Sign out 


Your Registration ta the Android Market is approved! 
You can now upload and publish sofware to ihe Android Market. 


Upload an Application 


Upload assets 


Draft application apk file — — Upload an apk file 


click the Laud button EL , : 
to publish draft apk fla Lhn No fle chosen 


Screenshot Add a screenshot e 
at leasi 2 [E ru x 480h, 4600 x S00h, 
: p Hika canna Ber Iter m 
24 bt PHG ni ne HI 
Full hlagd, mo bord 
Landscape Brei: are cropped 


High Resolution Application — Add a hi-res application icon: High Resolution Application Icom: 
| icon p] Stew 512h 


Lean Mori] EN HUS 24 bi PHG or JPEG (no alpha) 
Maximum: 1024 KE 


Promotional Graphic Adda ieiuna graghir Promo Graphic: 
optional come File oa) 180w x 120h 
: — gBibEPHG of JPEG (na alpha) 
Full bleed, na border in art 
Feature Graphic Adda feature graphic: Feature Graphic: 
optional | Choose File | Upload | 1024w x S00h 
| Choose File | Mo dla chosen 24 bit PNG or JPEG (no alpha} 
Will Be downsized to mini ar micro 
Promotional Video Add a promotional vdeo link: Promotional Video: 
ma 
Marketing Opt-Cut El Do nat promade my application except in Andid Market ard in any Google-aemed online or mobile 
properties. | urdersiand that any changes to thia preference may take eixty days to take effect. 
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图 12-18 展示 了 作者 已 向 Android Market 站 点 上 传 了 LBS.apk 文件 。 特 别 要 注意 ， 基 
于 您 上 传 的 APK 文件 ， 将 会 有 警告 消息 ,告诉 用 户 所 需 的 特定 的 权限 ,并 且 您 的 应 用 程序 
的 功能 将 被 用 来 作为 搜索 结果 的 筛选 条 件 。 例 如 ， 由 于 我 的 应 用 程序 要 求 接 入 GPS， 对 于 
那些 没有 GPS 接收 器 的 设备 的 用 户 ， 我 的 应 用 程序 就 不 会 在 他 们 的 搜索 结果 列表 上 显示 。 

EMI 


y C Developer Console x ES Graphic Assets for your Å.. « Y [5 Welcome to Developer La = UE 


€ C | marketandroid.com/publish/HomesEDIT APPLICATION?pkg-netlearn2develop.LB5 


Upload assets 


Draft application .apk file net_learn2devalop. LBS (18k) £4 Saved Draft 
click tha 'publish' button Where Am | [remove] 
to publish draft apk file Vee sonia. 4.0 
VersionCode: 1 
Localized to: default 


© This apk requests 3 permissions that users will be warned about 
android. permission INTERNET 
android permission. ACCESS FINE LOCATION 
android. permission. ACCESS COARSE LOCATION 


© This apk requests 4 features that will be used for Android Market filtering 
android. hardware location. network 
android hardware location 
android hardware. location.qps 
android hardware.touchscreen 


图 12-18 


需要 提供 的 下 一 组 信息 如 图 12-19 所 示 ， 包 含 了 应 用 程序 的 标题 、 其 描述 以 及 最 新 修 
改 的 细节 (对 于 应 用 程序 更 新 很 有 用 )。 还 可 以 选择 应 用 程序 的 类 型 和 在 Android Market 中 
所 属 的 类 别 。 


ige Developer Console 


€ > © © marketandroidcom/publish/Home#EDIT APPLICATION = 


Listing details 


Language | “English fen} | 
add language Star sign (^) indicates the default language. 


Title (en) Where Am | 


10 characters (30 max) 
Description (en) This application allows you to view visually where you are 
lncared using rhe Google Maps on your Android device. You can 
alge Emew the address of a location on the map by gimply 
touching on it. 


324 characters (4000 max} 


Recent Changes [en) 
VersianMHame- 1.0 


[Learn Mare] 


Ihia is the firat version of this application. 


46 characters (500 max) 


Promo Text [en) | 
E 


0 characters (80 max) 


Application Type | Applications [=| 
Category [Lifestyle — — [s] 


Price Free = Want to sell applications? Setup a Merchant Account at Google Checkout 
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在 最 后 一 个 对 话 杠 中， 可 以 指明 您 的 应 用 程序 是 否 采 用 版 权 保 护 以 及 指定 内 容 评级 。 
还 可 以 提供 您 的 网 站 的 URL 以 及 您 的 联系 信息 (如 图 12-20 所 示 )。 当 同意 了 两 个 准则 和 协 
议 后 ， 单 击 Publish 按钮 将 您 的 应 用 程序 发 布 到 Android Market E. 


d ii Developer Console 


€ Q |© marketandroid.com/publish/HomesEDIT APPLICATION 


Fublishing options 


Copy Protection a Off (Application can be copied from the device] 
© On (Helps prevent copying af this application from Ehe device. Increases the amount of 
memory on the phone required to install the apelication.) 
The copy protection feature will be deprecated soan, please use licensing serice instead. 


Content Rating £ Mature 
[Learn Mora] £j Taan 
a Pre-Teen 
All Thi rating option haz bean disabled by the Android Moret taam 
Select locations to list in: 


All locations 

(Includes more countries than these listed below. As the developer, you are responsible for complying 
with country-speciic laws related to the disiribution of sale of your application into that country, 
including your home country.) 


Contact information 


Website http: wa leamadevalop net 


Email wei menglee gmail cam | 


Phone | 


Consent 


l| This application maats Android Content Guidelines 
国 | acknowledge that my software application may be subject to United States expor laws, regardless of my location or nationality. | agree that | 


have complied with all auch laws, including ary requirements for software with encryption functions. | hereby certify that my application is authorized 
for export from the United States under these laws. [Leam More] 


Publish Save Delete 
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到 此 为 止 ， 您 的 应 用 程序 在 Android Market 上 就 可 用 了 。 您 将 能 够 查看 任何 已 提交 的 
关于 您 的 应 用 程序 的 评论 (如 图 12-21 所 示 ) 以 及 错误 报告 和 总 的 下 载 次 数 。 


d ii Developer Console x Xe \ 


= Q (C market.android.com/publish/Home#LliSTING CONSOLE 


3 market 


Developer Learning Solutions 
wemenges@gmailcom 
Edit profil x 


weimenglesigmail.com | Home | Halg | Android.c 


All Android Market listings 


ms "Where Am | vio [Op D tatal Published 
= Applications: Lifestyle Comments D active installs (096) 


* Upload Application 


Development phones 

As a registered developer, you can purchase an unlocked 
phone 

Bury now » 


Google checkout * 


Want to sell applications in the Android Market? 

Set up a Merchant account with Google Checkout! You will 
nead to enter additional information like your bank account 
infonmation and Tax ID 

Setup Merchant Account » 


€ 2010 Google - Android Market Developer Distibution Agreement - Google Terms of Serice - Prwacy Policy 
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视 您 好 运 ! 现在 ， 您 只 要 等 好 消 居 就 行 了 。 人 希望 很 快 您 就 能 一 路 笑 大 去 银行 ! 


123 本章 小 结 


在 本 章 中 , 我 们 学 习 了 如 何 将 Android 应 用 程序 导出 为 一 个 APK 文件 并 使 用 自己 创建 
的 一 个 密 钥 库 对 其 进行 数字 签名 。 然 后 ， 学 习 了 分 发 应 用 程序 的 多 种 方法 以 及 每 一 种 方法 
的 优点 。 最 后 ， 我 们 亲自 体验 了 在 Android Market 上 发 布 应 用 程序 所 需 的 步骤 ， 这 将 使 您 
可 以 出 售 您 的 应 用 程序 ， 并 且 带 来 更 多 的 用 户 。 和 希望 这 样 可 以 使 您 卖 出 更 多 的 产品 并 因此 
获得 不 错 的 收益 ! 


1. 如 何 指定 应 用 程序 所 需 的 Android 最 低 版 本 ? 

2. 如 何 生成 一 个 目 签 名 证 书 来 为 Android 应 用 程序 签名 ? 

3. 如 何 配置 Android 设备 ， 使 其 可 以 接收 非 Anroid Market 源 的 应 用 程序 ? 
练习 答案 参见 附录 C. 


本 章 主 要 内 容 
主 B 关键 概念 


要 在 Android Market 上 发 布 一 个 应 用 程序 ， 该 应 用 程序 必 
须 在 AndroidManifest.xml 文件 中 具有 以 下 4 个 属性 : 
android: versionCode, android: versionName, android: icon, 
android: label 

要 分 发 的 所 有 应 用 程序 必须 使 用 一 个 目 签名 证 书 进行 签 


用 于 发 布 应 用 程序 的 检查 表 


应 用 程序 必须 签名 
名 。 调 试 密 钥 库 对 于 分 发 来 说 是 无 效 的 
| | | 使 用 Eclipse 的 Export 功能 将 应 用 程序 导出 为 一 个 APK X 
导出 一 个 应 用 程序 并 对 其 签名 
= 件 并 使 用 一 个 自 签名 证 书 对 其 签名 

以 使 用 各 种 方式 部 署 ，Web 服务 器 、 电 子 邮件 、adb.exe 

可 以 使 用 各 种 方式 部 署 ，Web 服务 器 、 电 子 邮件 、adb exe 
和 DDMS 等 


一 次 性 花费 25 美元 向 Android Market 进行 申请 ， 这 样 就 可 


在 Android Market 上 发 布 应 用 程序 | me 
以 在 Android Market 上 托管 和 出 售 应 用 程序 
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AE Google 文 持 使 用 诸如 IntelliJ 这 样 的 IDE 或 者 像 Emacs 这 样 的 基本 编辑 砷 来 进行 
Android 应 用 程序 的 开发 , 但 它 还 是 推荐 将 Eclipse IDE 和 ADT 插件 一 起 使 用 。 这 样 做 可 以 
使 开发 Android 应 用 程序 变 得 更 容易 也 更 高 效 。 本 附录 描述 了 Eclipse 中 可 用 的 一 些 可 以 使 
您 的 开发 工作 变 得 更 加 容易 的 极 好 功能 。 


警告 : 如 果 您 还 没有 下 载 Eclipse， 那 么 可 以 从 第 1 章 开 始 学 起 。 在 那里 ， 您 
将 学 到 如 何 获 取 Eclipse 以 及 对 它 进 行 配置 ， 使 其 可 以 和 Android SDK 一 起 使 
用 。 本 附录 假定 您 已 经 为 Android 开发 设置 好 了 Eclipse 环境 。 


A.1 Eclipse tit 


Eclipse 是 一 个 高 度 可 扩展 的 多 语言 软件 开发 环境 ， 可 以 文 持 各 种 应 用 程序 开发 。 使 用 
Eclipse， 可 以 利用 多 种 语言 来 编写 和 测试 应 用 程序 ， 例 如 Java, C, C+, PHP, Ruby 等 。 
由 于 其 可 扩展 性 ，Eclipse 的 新 手 币 第 感到 对 其 IDE 无 所 适 从 。 因 此 ， 以 下 小 节 的 内 容 旨 在 
帮助 您 在 Android 应 用 程序 的 开发 过 程 中 可 以 更 加 熟练 地 使 用 Eclipse. 

A.1.1 工作 区 
Eclipse 采用 工作 区 (workspace) 的 概念 。 所 谓 工 作 区 就 是 您 所 选择 的 用 来 保存 所 有 项 目 


的 一 个 文件 来 。 
当 第 一 次 启动 Eclipse 时 ， 将 提示 您 选择 一 个 工作 区 (如 图 A-1 所 示 )。 
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Workspace Launcher 


Select a workspace 


Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session, 


Workspace: | Users Wei- Meng Lee\Beqinning Andr 


[E] Use this as the default and do not ask again 


图 A-1 


当 Eclipse 将 位 于 工作 区 中 的 项 目 启 动 完 之 后 ， 将 在 IDE 中 显示 几 个 窗 格 (如 图 A-2 


EH lava - Basicviewsl/sr/net/leamzdevelop/BasicViewsl/Main&ctiviry java - Eclipse 
File Edit Run Source  Mavigate Search Project Refactor Window Help 


(B iS arid :d-0-Q- B G-im534- SS 大 Debug um DDMS (ai lave ) T? Java EE 


: d LIES th oy io 


=O m Iain Activity.java E ^ 
ER package nct.lcarnzdcvclop.BasicVicwa31; 
> [el AdditionalViews 
a 3. BasicViewsl 
uu = ree ee public class MainActivity extends Activity 4 
disc arias erg /** Called when the activity is first crcate|- 
p |J] MainActivity jew MainActivity.jewa| 3 BOverridc 
_ 一 lawa Clas] £ 
b dl gen [Generated java Files] public void onCreate (Bundle savedInstanceSta 
p =. Android 2.2 super.oncreare|savedInstancestate|: 
Go assets aerconrenrview[R.lawour .main): 
b 2 res 
X Androidhlanitestarnl //---Button view--- 
E] default properties Button btnOpen = [Button| findViewById(|(E 
> LE! BasicViews2 btnOpen.getOmClickLiztener new View .OnCl 
> E BasieViews3 | public void cnClick|View v) { 
> XS BasicViews4 DisplayToast ("You have clicked T 
> 加 BasicViewss } 
> ie BasicViews5 bye 
b ud Gallery 
> E Grid 
司马 IrnageSwitcher 
> i Menus 
» VS) WebView 


"import android.app.Activity:; 


ff---Butran view--- 
BUTTON brtnSave = (Button) TimndviewbBwId(R 
btn35ewr.setoóncClickListener|new View .Cncl 
i 
publia void onClick |View w} { 
DisplayInazt|"Ynu have clicked t 


! M —Ó 
E "a T i = 
图 Problems @ Javadoc |[, Declaration | Il Console 加 - 


i i neblearnédevelop.BasicViewsL.Maindchwity java - BasicViewsL'sre 


图 A-2 


下 面 的 小 节 将 对 在 开发 Android 应 用 程序 时 必须 了 解 
的 一 些 较 重 要 的 窗 格 进行 重点 讲解 。 


A.1.2 Package Explorer 


如 图 A-3 所 示 , Package Explorer 列 出 了 当前 位 于 工作 区 
中 的 所 有 项 目 。 要 编辑 项 目 中 一 个 特定 的 项 ， 可 以 双击 这 一 
项 ， 文 件 将 会 显示 在 各 目的 编辑 器 中 。 

还 可 以 右 击 在 Package Explorer 中 列 出 的 每 一 项 ， 以 显 
示 与 所 选项 有 关 的 上 下 文敏 感 菜 单 。 例 如 ， 如 果 希 望 在 项 目 
中 添加 一 个 新 的 .java 文件 ， 可 以 在 Package Explorer 中 右 击 
包 的 名 称 ， 然 后 选择 New | Class (如 图 A-4 所 示 )。 


—————M——— 
iles a ^ ra r 
p= Outline 25 ™ a 


eae wt? 
AA netklearn2devel op .BasicViewsL 
“三 import declarations 
(9 MainActivity 
$a onCreate(Bundle) ; «cid 
GR new OntClickListener( [...] 
GR new OnClickListener( f...] 
G newOnClickListener() [...] 
(à new OnCheckedChangeList 
GR new OnClickListener() [...] 
g Display] past(String) : voici 


b E AdditionalViews 
4 > BasicViewsl 
à [8 sm 
4 H} netleam2develop.BasicViewsl 
b | 四 Ma inActvity java) 
p ia gen [Generated Java Files] 
D EA Android 242 
Els. assets 
E an res 
4d AndroidManifest.xml 
default.properties 
p E2 BasicViews? 
b EE Basicwiews3 
p oe Basicviews4 
b ES BasicViews5 
b ES BasicViewsb 
p us Gallery 
> Le Grid 
b us ImageSwitcher 
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res Java - BazicViewz 1/zrc/net/learnZdevelop/BasicViews1/MainActivity. java - Eclipse 


File Edt Run Source Navigate Search Project Refactor Window Help 


| Îr | Additional ews 
a > BasicViewsl 
a (B sic 
4 E netJeamidevel 


t [f] MainActivit 


p a gen [Generated Jav, 
b Be Android 2.2 
(Go. assets 
b i res 
4c Android Manifest.x 
[E] default.propertie: 
. | BazicWiewsz 
, tee BasicViews3 
| ym Basic Views4 
! A BazicViewss5 
. XS BasicViewsb 
, de Gallery 
. E Grid 


ie ImageSwitcher 
. ES Menus 
‘= WebView 


net.earnz develop 


5 Bai i *-O-Q-i#@- BAF 


um La to = T 


m E 
= A|| [fj MainActivityjava 9 ~ 


zz 
E 


m E | = a 


] 
1 


RaricWMicaurl | 
Mew 
Ga Inte 


Open in Kew Window 
Open Type Hierarchy 


Show In 


Capy 

Copy Qualified Name 
Paste 

Delete 


Remove trom Context 
Euild Path 
Source 


Refactor 


Import. 
Export... 


References 


Declarations 


Refresh 
Assign Working Sets... 


A1.3 使 用 其 他 工作 区 的 项 目 


也 许 您 有 时 候 会 创建 多 个 工作 区 来 存储 不 同 的 项 目 。 如 果 需 要 访问 男 一 个 工作 区 中 的 
项 目 ， 通 常 有 两 种 方法 可 以 实现 这 一 点 。 第 一 种 方法 是 选择 File | Switch Workspace( 如 图 
A-5 所 示 ) 切 换 到 您 所 希望 的 工作 区 。 指 定 新 工作 区 后 重新 启动 Eclipse。 


© Java - Eclipse 


^ 


| import android.app.Activity:; 
| 
| 


rä 


4 


Fi 
Alt+ Shift W k 


Ctil-C 


Ctrl+V 
Delete 


Ej $*De 


$ package ner .learnz2develop .Bagieviewsi:; 


publia class MainActivity extends Activity [ 


Jawa Project 
Android Project 
Project... 


Package 
Class 
Interface 
Enum 
Annotation 


Source Folder 


| Java Working Set 


Ctrl - Alt-Shift- Down 
LI 
Alt-Shift- 5 & 
Alt-Shift-T b 


图 A-4 


Folder 

File 

Untitled Text File 
Android XIMIL. File 
JUnit Test Case 
Task 


Example... 


Other... Ctrl+M 


[ File | Edit Run  Mavigate Search Project Refactor Window Help 


New 


Open File... 


Close 


Close All 


Save 
5ave As... 
Save All 
Rewert 


Mowe.. 
Rename.. 


Refresh 


AlteShifteN + ko jf | ere 


Etri- W 
Cr n Shift- W 


Cir 5 


Ctrl Shift 5 


Q- gg- 9 


Convert Line Delimiters To 
Print... 


Switch Worespace 
Restart 


Import... 
Export... 


Properties 


LInvocationTargetException.class [ja..] 


2 Looper.class fandroid.os.Looper] 
3 5endSMSLab.java [5endSMSLab/src/...] 


3 View.class [android.wiew View] 


Exit 


CN\Users\ Wei-Meng Lee\yworkspaces 
C\Wsers\ Wei-Meng Leekworkspacez 
C\Users\ Wei-Meng Leevworkspace 


Other... 


Alt-- Enter 


图 A-5 


第 二 种 方法 是 将 项 目 从 另 一 个 工作 区 导入 到 当前 工作 区 中 。 要 做 到 这 一 点 ， 选择 File | 
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Import...， 然 后 选择 General | Existing Projects into Workspace( 如 图 A-6 所 示 )。 单 击 Next. 
在 Select root directory 文本 框 中 输入 包含 想 要 导入 的 项 目的 工作 区 的 路 径 ， 并 选中 这 
些 项 目 ( 如 图 A-7 所 示 )。 单 击 Finish 按钮 ， 导 入 所 选择 的 项 目 。 


Import Projects 


Select a directory to search for existing Eclipse projects, 
Select 


Create new projects From an archive file or directory. ———————— 
© Select root directony = CAUsersWei-hMeng Leewrorkspace 


i © Select archive file! | | | 
Select an import source: 一 一 一 一 一 


| type filter text Projects: 


4 (= General [E] ActivityLab (C:\Users\Wei-Meng Lee\workspace\Act + 
i Archive File [^] BazicUlLab (Cn Uzer Wei- Meng Leevworkzpace.Bas | 
L^ Easting Projects into Workspace [4] DatabaseLab (CAUrers\Wei-Meng Lee\workspacelD T | Desc ect All | 
加 File System [4] DialogsLab (Cr. Users Wei- Meng Lee\workspace Lia — 
E, Preferences [^] FilesIOLab (CXUsers AW ei-Meng Lee\workspace\Files 

b E CVS [^| Helle World (CAUsersiWei-Meng LeevworkspacekHe 

t E EIB [^] Ht£pLab (O\Users\Wei-Meng Lee\workspaceHitpLi 

b E hwa EE IntentLab ice e sodas center, 


ae 


> > Plug-in Development bd [a | | j 
p p Remote Systems 
b E Run/ Debug 

t [E Tasks Working sets 


F Copy projects into workspace 


> [X Team [E] Add project to working sets 
E [Web 


mo [m Wah cervir er 


Working ets: 


A-6 图 A-7 


注意 ， 当 从 另 一 个 工作 区 将 一 个 项 目 导 入 到 当前 工作 区 中 时 ， 导 入 项 目的 物理 位 置 保 
持 不 变 。 也 就 是 说 ， 项 目 仍 旧 位 于 其 原始 目录 下 。 要 在 当前 工作 区 中 保留 项 目的 一 个 副本 ， 
可 选中 Copy projects into workspace 选项 。 


A.1.4 在 Eclipse 中 使 用 编辑 器 


根据 在 Package Explorer 中 双击 的 项 目的 类 型 ，Eclipse 将 为 您 打开 对 应 的 编辑 器 来 编辑 文 
件 。 举例 来 说 , 如 果 双击 一 个 java 文件 , 将 打开 用 于 编辑 源 文件 的 文本 编辑 器 (如 图 A-8 所 示 )。 


Ope e poe ee 

Hie Edit Bun Source Navigate Search Project Refactor Window Hep č > 
lm-Hg A BEdt-O-Q- dSg- fos RT 
iTEXSemmili-u-we--- 

| B Package Explorer pg im = is |J] Main 


package nrt.lecnrnédcovclop.Bnsicvicw31:7 
[== Additianal'iews : TEE "E 
Z er c "E bI = r t tv: 
T Basic Views! EF m app xin ¥ 
import amdroid.os.Bundle; 
p src 


E ee ques Vicus import andcoid.view. View; 
国 MainActivity java import android.widget.Burten; 

IB gen [Generated Java Files] import android. witget. Checkbox; 

BA Android 24 import andreid.widget. RadioButton: 

e assets android.widget.RadioGraup: 

gre wport android.widget.Toast: 

dz] AndroidManifest.xrl t amdroid_widget.ToggleButton: 

[E] default properties i t android. widget .RadioGroup.OnCheckedChangeListener: 
i= BasicViewsz 
E3 BasicViews3 io oless Mainlctivity extends Activity i 


E BasicViewesd e fe" Called when the activity is first created. */ 
ES. BasirVigws* n BOoverride 

[> EmirViewes = public void onCreate (Bundle savedInatanceState) { 
LS Gallery me gupaer,onCreare|[savedInsranceSrare]: 

H Grid d agtconrtentView|R.layeut.masin|: 


g ImeageSuite her 
Le Menus 
强 WebView 


/J?f-—---Buttnm riew-—— 
Button btnÜpen = (Button) findViewById(B.id.b£mZpen|: 
benOpen.setOmClickListener (pew View .OnClickListener() i 
publico void onClickiView wi i 
DisplayToast ("You have clicked the Open button"); = 
Lj k 


图 A-8 


附录 A 使 用 Eclipse 进行 Android 开发 


如 果 双 击 res/drawable-mdpi 文件 夹 下 的 ic launcherpng 文件 ， 将 局 动 Windows Photo 
Viewer 应 用 程序 来 显示 图 像 ( 如 图 A-9 所 示 )。 


区 | ic launcher.png - Windows Photo Viewer 


File ~ Print * Emal Bum * Open ™ 


如 果 双 击 res/layout 文件 夹 下 的 main.xml X fF, Eclipse 将 显示 UI 编辑 器 ， 在 那里 可 
以 以 图 形 化 方式 查看 和 构建 UI 布局 (如 图 A-10 所 示 )。 
Q8] Java - BasicViewsl/res/layout/main.xml - Eclipse 


ET ie a & mh d | *-Q-G- EG E | et? Java | 5 Debug E DOMS p% lava EE 
S 巴 "S E ? rp 


ww 


IB Package Explorer H 


Tl a | = | 

Lan. Editing config: default |An (locale ~| | Android 22  *||Create..| | 
D m ActivitylOL | : : n | | | 
a (ce! BasicViewsl | [3 Fin WGA [Nexus One + [Portrait ~| Normal ~ Theme: 
| F (e Sc 


> E3 gen [Generated Java Files] [E] Palette e 6€» Ul | eem 
b Ba Android 2.2 r —— ( 


Go asscts 


M | 


> E> bin 
i res 
t = drewable-hdpi 
t C& drawable-ldpi 
D [5 drewable-mdpi 
a (& layout 
| X; main.xml 
t [m values 
fo) AndroidManrfest.am! 
Ej praguard.cfg 
Ej project.properbes 
IN- m Databases 
|| 5 i Dialog 
| t = EE 
|| b g Files 
IN. m Fragments 
|| b g8 HelloWorld 
| b E ImageSwitcher 


| ceu 
|| > 5 ISON 
TEN TT 


E Problems| @ Javadoc B D'eclarabon g Consola =p LogCat oP * 


| m nonu EE ewsl/res/layout Android SOK Content Loader 


图 A-10 


要 使 用 XML 手动 编辑 UL, P WG T 2 4H AS ER BAY main.xml 选项 卡 , 切换 到 XML 
视图 (如 图 A-11 所 示 )。 
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GE ava -Basicwiewsliresllayoubrnainmil - Eclipse 

File Edit Refactor Bon Source WMavigate Search Project Window Help 

Slee 86 Sea Sig ie) death NUN F5 (Bi ava |$ Debug df DOMs $ lava EE 
Bum -:H:Z f = 

[H Package Explorer Ez ~ 


Eum xfxwml wer -"IE.8" encoding-"utf-8 
= Activity =] j ees http: ethem. android. como res onirotd 
W! BasicViews! 


= E idr bhtniove" 
TER Peen me" 
wrap content" 


(= drawable-hdpi “Button android: id= "Brid/btnüpen" 

ie rold:layout width-* wrap content" 
= : android: layout_ be“ "wrap content" 
M android:text-"npen* 


(= drawable-ldpi 


xInageButton android: id="B+to/btrDagt" 

spoke EEL sh eS 

c Andraidhdanifest.sml Enc youi es oars 

E proguard.cfq 

E project. properties SEditText android;id-" Be id/txtWame" 

a android: la ae t width= eo mE" 

android:layout heipght-"wreap cantent" /* 

drai 


ae a "Ecdrawsbiz/ic Launcher" j> 


¿Checkbox android:idz Beid/chkbautazcwe" 
andro E a atk "fiL parent" 
sad old:layout height-"Wrop content" 

android:text-"Avtesawe" > 


三 | Graphical Lay mut |>) main xrnl 
B By a 


r|- T m 一 E T- er- 
时 | Problems | @ Javadoc li. Declaration | [2] Console | EB Legat. 72 ba. 


ole ® LinearLayout/Button/andraicsid _ Android SDK Content Loader 


图 A-11 
A.1.5 理解 Eclipse 透视 图 


在 Eclipse 中 ， 透 视图 erspective) 是 一 个 包含 一 组 视图 和 编辑 器 的 可 视 化 容器 。 当 在 
Eclipse 中 编辑 Android/Java 项 目 时 ， 您 就 处 于 Java 透视 图 中 (如 图 A-12 所 示 )。 

Java EE 透视 图 用 于 开发 企业 级 的 Java 应 用 程序 ， 它 包含 了 与 之 相关 的 其 他 模块 。 

通过 单 击 透 视图 的 名 称 可 以 进行 透视 图 的 切换 。 如 果 透 视图 名 称 没 有 显示 ， 可 以 单 击 
Open Perspective 按钮 添加 一 个 新 的 透视 图 (如 图 A-13 所 示 )。 


ier DOMS 

$s Debug 

(eJ Java Browsing | 

3 @ JavaScript CETERI 
Other... | LinearLayout 
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DDMS 透视 图 包含 了 与 Android 模拟 器 和 设备 进行 通信 的 工具 。 在 附录 B 中 将 进行 详 
细 介 绍 。Debug 透视 图 包含 了 用 于 调试 Android 应 用 程序 的 窗 格 ， 本 附录 稍 后 将 对 此 进行 
详细 介绍 。 
A.1.6 包 的 自动 导入 


Android 库 中 的 各 种 类 是 以 包 的 形式 组 织 起 来 的 。 因 此 ， 当 使 用 包 的 一 个 特定 的 类 时 ， 
需要 导入 适当 的 包 ， 如 下 所 示 : 


import android.app.Activity; 
import android.os.Bundle; 
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由 于 Android 库 中 类 的 数目 非常 巨大 ， 要 记 住 每 一 个 类 所 属 的 正确 的 包 不 是 一 件 容易 
INS. SAIS AE, Eclipse 可 以 帮 您 找到 正确 的 包 ， 使 得 您 只 要 单 击 鼠标 就 可 以 导入 它 。 

图 A-14 展示 了 本 书 作者 所 声明 的 一 个 Button 类 型 的 对 象 。 由 于 作者 没有 为 Button 类 
导入 正确 的 包 ，Eclipse 在 语句 下 面 提示 一 个 错误 。 当 将 鼠标 移动 到 Button 类 的 上 和 面 时 ， 
Eclipse 会 显示 一 个 修改 建议 列表 .在 本 例 中 ,需要 导入 android.widget.Button 包 。 单 击 Import 

‘Button”(android.widget) 链 接 将 在 文件 开头 添加 导入 语句 。 


Package net.learnz2develop.Hasicviewal; 


8 import android.app.Acriviry:[] 


public class pm eru extends ae eee { 
= /** Called when the riviry iz first created. */ 
GÜnzerride 
publi pm onCreste (Bundle savedInstanceStnmte) £f 
cin üonCreare(gawedInsrancesrare);: 
etCaontentView (R.layout.main} ; 


ff/---Butteamn view- 
Button btnOpen = (Button) findViewHyId(ER.id,.btnOpen]); 
BckListener() 1 


hc Open button" 


或 者 ， 可 以 使 用 如 下 的 组 合 键 : Controlt+Shiftto。 这 一 组 合 键 将 使 Eclipse 自动 导入 您 
的 类 所 再 要 的 所 有 包 。 


A.1.7 使 用 代码 完成 功能 


Eclipse 另 一 个 非常 有 用 的 功能 就 是 支持 代码 完成 。 当 您 在 代码 编辑 器 中 输入 内 容 时 ， 
代码 完成 会 显示 一 个 上 下 文敏 感 的 相关 类 、 对 象 、 方 法 以 及 属性 名 称 的 列表 。 例如 , 图 A-15 
展示 了 起 作用 的 代码 完成 功能 。 在 我 输入 单词 fin 时， 通过 按 下 Ctrl+Space 组 合 键 能 够 激 
活 代码 完成 功能 ， 这 时 将 出 现 一 个 以 fin 开头 的 名 称 列 表 。 


public void ontreate (Bundle savedInstancestate) i 
super.onCreBate(savedlInstanceState); 
setContentView (R.layout.gain) ; 


/f—_—-Buttoan xview--— 
Burton brnopen = rin 
B findViewEyld(nt id) : View - Activity 
x finalize(] : void - Object 
& finish(): word - &ctroty 
& finishActivityiünt request ade] : void - ^ctuty 
® finishActivityFromChild (Activity child, int requesttode) : voi 
& finishFromChild(Actwrty child) : void - Activity 


1 [L—ÓÁ—— L1 


— Pres; Ctrl-Space' to show Tamplate Proposals 


图 A-15 


要 选择 所 需 的 名 称 ， 直 接 在 其 上 双击 或 者 使 用 光标 高 亮 显示 它 并 按 Enter 键 就 行 了 。 
在 一 个 对 象 /类 名 之 后 输入 period(。) 时 ， 代 码 完成 也 可 以 起 作用 。 图 A-16 展示 了 
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| 示例 o 
public void onCreate (Bundle savedInstanceState) { 


super .onCreate (savedinstanceState)-: 
setContentView(R.layout.main): 


TORRE. 


class : Class< android.widget.Toast> 
o? LENGTH LONG : int - Toast 
e LENGTH. SHORT : int - Toast 
m makeT ext(Context context, CharSequence text, int duration) : 


e makeText(Context context, int resid, int duration): Toast - Tc 
this 


" d 
Press 'Ctri-Space to show Template Proposals | 


图 A-16 


A.1.8 重 构 


重 构 是 大 多 数 现代 IDE 文 持 的 一 个 非常 有 用 的 功能 。Eclipse 文 持 大 量 的 重 构 功能 ， 可 
用 来 有 效 地 进行 应 用 程序 开发 。 

在 Eclipse 中 ， 当 将 光标 放 到 一 个 特定 对 象 /变量 上 时 ， 编 辑 器 将 突出 显示 当前 源 中 所 
选 对 象 出 现 的 所 有 地 方 (如 图 A-17 所 示 )。 


//---Button view--- 
Button btnOpbn = (Button) findViewByIld(R.id.btnOpen): 
btnOpen.setOnClickListener(new View.OnClickListener() { 
public void onClick(View v) { 
DisplayToast ("You have clicked the Open button"); 


图 A-17 


这 一 功能 对 于 确定 一 个 特定 对 象 在 代码 中 的 位 置 是 非常 有 用 的 。 要 改变 一 个 对 象 的 名 
称 ， 可 右 击 它 并 选择 Refactor | Rename...( 如 图 A-18 所 示 )。 


public class MainActivity extends Activity [ 
/** Called when the activity is First created. ^/ 
@O0verride 
public void onCreate |Bundle zavedlInstanceState) f 
super.onCreate[savedInstanceSstnte!: | 
sctContentViec| 4 Unde Typing Mowe.. Ale+ Shitt+¥ 


Alt+Shitt+ R. 


TE Pever E Change Method Signature... Alte Shifts C 


Button eie = Save Extract Method... Alt+ Shift M 
BEBOpen - iaa: Open Declaration Extract Local Variable... Alte Shitt+ L 
sia ee Üpen Type Hierarchy | Extract Constant... 
I Open Call Hierarchy Ctr Alt- H Inline... Alt+Shitt+l 
rs Show in Breadcrumb Alte Shift+ B 
PM Quick Outline Ctrl 
Ricci Quick Type Hierarchy CET Es i 


btn5awe,.setün Show In Alt-ShiFE- M I 
{ Use Supertype Where Possible... 
public vo Cut CE X Pull Up... 


Comert Local Variable to Field... 


Extract Superclass... 


pour Copy CC Push Den... 
Copy Qualified Marne 


Hz : 
Paste Cira V Extract Class... 


//---CheckBo Introduce Parameter Object... 
CheckBox che 
checkBox.seto Source Alt+Shift+5 » 
1 Refactor Alt+Shitt+T I Generalize Declared Type... 
I p e Surround With Alte Shift-Z rr 
i 
^ Local History I 


Quick Fix Ctri+L 
Introduce Parameter... 


图 A-18 
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在 输入 对 象 的 新 名 称 后 ， 该 对 象 出 现 的 所 有 地 方 将 动态 变化 (如 图 A-19 所 示 )。 注 意 
为 了 使 重 构 能 够 正确 地 工作 ， 代 码 中 不 能 有 任何 语法 错误 ， 而 且 必须 能 够 被 编译 器 正确 
地 编译 。 


//---Button view--- 
Button wees = (Button) findViewById(R.id.btnOpen): 


nef Vera Lp — OnClickListener() 1{ 
yd Enter new name, press Enter to refactor ^w | 


DisplayToast ("You have clicked the Open button"): 


图 A-19 


男 外 一 个 重 构 十 分 有 用 的 领域 是 从 UI SO Se BM E. Wm Ig, 
在 用 户 界 面 中 使 用 的 所 有 学 符 串 凋 量 最 好 都 存储 到 strings.xml 文件 中 ， 这 样 会 方便 以 
后 进行 本 地 化 。 然 而 在 开发 过 程 中 ， 开 发 人 员 经 第 采取 一 种 便捷 的 方法 ， 即 直接 输入 
字符 串 和 常量。 例如 ， 您 可 能 会 使 用 一 个 字符 串 常 量 设置 Button 视图 的 android:text 属 
性 的 值 : 

«Button android:id="@+id/btnSave" 

android: layout width="fill parent" 


android: layout height="wrap content" 
android:text="Save" /> 


在 Eclipse 中 使 用 重 构 功能 时 ， 可 以 选择 该 字符 串 弟 量 ， 然 后 选择 Refactor | Android | 
Extract Android String..., "lE A-20 所 示 。 


I) Java - BasicViewsl/res/layout/main.xml - Eclipse 


Change Widget Type... 
Change Layout... 
Remove Container... 


Wrap In Container... - - 
g="utf-8"?> 
a 一 一 Extract Style... ="http://schemas.¢ 
pa oe Extract as Include... 
‘vo BasicViewsl -一 一 ~- - 
5 Databases Extract Android String... Alt+Shift+A, S 
得 Dialog vm B 
¿Button android: id="@+id/btnSave 


cal j 
Yo Emails android: layout widthz"fiLL parent" 


me w android: layout height-"wrap content" 
yS Fragments z android:text-" EE" /> 
$3 HelloWorld 

(8 sre «Button android: id="@+id/btnOpen” 

€s gen [Generated Java Files] android:layout width-"wrap content 


android:layout height-"wrap content" 
android:textz"Open" /» 


E) Android 4.0 
€ acca 


A-20 


然后 Eclipse 将 会 提示 您 为 该 字符 串 常量 指定 一 个 名 称 ， 如 图 A-21 所 示 。 完 成 之 后 ， 
单 击 OK 按钮 。 
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fy Extract Android String 


String Replacement 


String Save 
Replace by R.string. 


XML resource to edit 


Configuration: 


Available Qualifiers Chosen Qualifiers 
Xx Country Code 

fT Network Code 

E language 

xx Region 

EH Smallest Screen Width 

++ Screen Width 

i Screen Height 


Resource file: — /res/values/stnngs.xml 


Options 
[ | Replace in all Java files 
E] Replace in all XML files for different configuration 


图 A-21 


之 后 ，android:text 属性 的 值 将 被 奉 换 为 @string/save: 


<Button android:id="@+id/btnSave" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/save" /> 


如 果 观 察 strings.xml 文件 ， 会 发 现 它 现在 包含 一 个 名 为 save 的 新 条 目 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«resources- 
«string name="hello">Hello World, BasicViewslActivity!</string> 
«string name-"app name">BasicViews1</string> 
«string name="save">Save</string> 


</resources> 


对 于 重 构 的 详细 讨论 超出 了 本 书 的 范围 。 想 要 了 解 Eclipse 中 更 多 关于 重 构 的 信息 ,可 
以 访问 www.ibm.com/developerworks/library/os-ecref/ 。 


A.2 调试 应 用 程序 


Eclipse 支持 在 Android 模拟 器 以 及 真实 的 Android 设备 上 进行 应 用 程序 的 调试 。 当 在 
Eclipse 中 按 下 FF11 SET, Eclipse 将 首先 确定 是 否 已 经 在 运行 一 个 Android 模拟 器 的 实例 或 
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是 连接 了 一 个 真实 设备 。 只 要 有 一 个 模拟 需 ( 或 设备 ) 运 行 ，Eclipse 就 会 将 应 用 程序 部 普 到 
运行 中 的 模拟 器 或 已 连接 的 设备 上 。 如 果 既 没有 模拟 器 运行 义 没 有 连接 设备 ，Eclipse f H 
动 局 动 一 个 Android 模拟 器 的 实例 并 将 应 用 程序 部 署 在 其 上 面 。 

如 果 有 多 个 模拟 器 或 设备 连接 ,Eclipse 将 提示 您 选择 一 个 目标 模拟 器 /设备 ,以 便 在 其 
上 部 署 应 用 程序 (如 图 A-22 所 示 )。 选 择 一 个 您 想 使 用 的 目标 设备 ， 然 后 单 击 OK 按钮 。 没 
有 运行 应 用 程序 所 需 的 最 低 OS 版 本 的 设备 将 带 有 一 个 义 标 记 。 


8 Android Device Chooser 


Select a device compatible with target Android 3.2, 

(9 Choose a running Android device 
Serial Number AVD Name Target Debug State 
E emulator-5554 Android 4.0 «f Android 4.0 Yes Online 


2 3733EG70ED8200EC N/A 其 236 Online 
ig 4370814206597 N/A 9 321 Online 


O Launch a new Android Virtual Device 
AVD Name Target Name Platform CPU/ABI Details... | 
Android 4.0 Tab... Google APIs (Google Inc.) 40 ARM (armeabi-... Start | 
Android 4.0 Wit... Google APIs (Google Inc.) ^ 40 | ARM (armeabi-... 一 


Refresh | 


Manager... | 


图 A-22 


如 果 想 启动 一 个 新 的 模拟 器 实例 来 测试 应 用 程序 ， 可 选择 Window | Android SDK and 
AVD Manager 来 启动 AVD Manager. 


A.2.1 REHA 


设置 断 点 是 临时 暂停 应 用 程序 的 执行 ， 然 后 检查 变量 内 容 和 对 象 内 容 的 一 个 好 方法 。 
要 设置 一 个 断 点 ， 可 双击 代码 编辑 器 中 的 最 左 列 。 图 A-23 展示 了 设置 在 一 个 特定 语 
名 上 的 断 点 。 


//———Button view——— 

Button btnOpen = (Burton) findViewById(R.id.btnOpen): 

btnüpen.setOonClickListener (new View.OnClickListener() { 
public void oncClick(View v) i1 


String str = "You have clicked the Open button"; 
DisplayToast (str); 


A-23 
当 应 用 程序 运行 到 第 一 个 断 点 时 ，Eclipse 将 显示 一 个 Confirm Perspective Switch XJ i5 
框 。 从 根本 上 说 ， 它 希望 切换 到 Debug 透视 图 。 为 了 防止 再 次 出 现 这 一 窗口 ， 在 底部 选中 
Remember my decision 复 选 框 并 单 击 Yess ILE, Eclipse 突出 显示 了 断 点 (如 图 A-24 所 示 )。 
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Debug - Basic Views L/src/net/lesrnZdevelapi/BasscVviews lainAciity. sva - Edipse 
File Edit Eum Source Navigate Search Project Refactor Window Help 
Be if Bagi et -O-Q-' eo - Pe E qi (BF Debug R DOMS Ép Java v Java EE 


HF Debug 52°. sk Servers] = H | [E Variables | Se Breakpoints| Expressions 23. = m | 
L3: MEM west | ae ta | d 4B | + x 
只 Thread [z1» main] Suspended (breakpoint at line 27 in MainActivityS1)) Name Value + 
Mainåctritygl.onClickiew] line: 27 ES 
Button [View).perf onmi lick [) lime: 2408 x = EN 
ViewSPerfarmz liek. rung line: 2816 En = 
VWiewRoot{Handler).hbandleCallback(lessage) line 587 zy "ur You have clicked the Open ... 
ViewRootHandler dispate hMessagettessage) lire: %2 


Looper loopy) line 123 
Activity Thread. main [5trinq[T) line: 4627 


Eisel 一 1 t.-L-blow.- fbi ee FELT. eet Pee FI Gl. Fee 


4 | TT -f 4 t 


| a — 


null 


ep Add nere expression 


T 


[cl marinzml Tub Instrumentatian. class [ lainActiwibrjmea Eo = O || oF Outline ER bs 2 l Lu ew uu | 
net deam? develop. Basic Viewsl 
//—-—-Burrom viegw--- "x import declarations 
Burton brnGpen = [BEurron) findviewById(R.id.btn (9. MieinActraby 
ptnopen.asetoncClickListeneringew View. OnClickLiast ij üa mireta Bundle): void 
publio void antlick(View v) I i new OnCliekL istenert) [...] 
String str = "You have clicked the Open @.. onClick(View) : void 
DisplayToast |scr|; new OnClick isteneni [...] 
[3 new DnClick istenert) £L... 
Hs new OnCheckedChangeListenert) [n] 
new OnClick sterner’ [..9 
isplayToast[Stong) : void 


ff---Button yvyiew--- 
Button Ltnseve = (Button) findViewById(R.id.btn. 
btnS5avEe,aetÜ0onClickLiztener(nmew View. OnClickList | 


E Console £i 7. 25) Tasks | zx BE | j D: MS GO IDEO +H =| Ro) 
Andraid 

[2010-11-28 22:44:54 - HasicViewsi] 

[2010-11-28 22:44:54 - BasicViewsl1] Android Launch! 
3 | — | | — " 

: | 27:4 > Launching BascVievest 


此 时 ， 可 以 利用 如 图 A-25 所 示 的 不 同 的 选项 (Watch、Inspect 和 Display)， 右 击 任意 选 
择 的 对 象 /变量 来 得 看 它们 的 内 容 。 


üíf---Buttnn view—-4 Declarations 
Button htnÜOpen = | : 
> btnÜpen.setOnClich G Add to Snippets... 
public void of Step Into Selection EE 
String Iram 
DizplavTaoes 7 
+ CA Inspect Ctrl=Shitt+l 
He J| Display Ctrl+ Shifts D 
ff---Button view-- Qj Execute Ctrl+U 
Button btnsave |=] Runto Line Ctri-R 
Cn Lim 3c n 


图 A-25 


图 A-26 展示 了 使 用 Inspect 选项 显示 str 变量 的 内 容 。 


ff--—-Button view--- 
Burton brtnOpen = (Button) findViewById(R.id.btnOpen): 
bcnüpen,.setünüclickListener(naw View.üniílickListenger() { 
public void onClick(View wv) { 
String str = "You have clicked the Open button"; 
DisplayvIoast (etry 
a @ str= "You have clicked the Open button" (d-8300677793765] 
a count= 32 
a hazhCaode- 5681881161 
Pi offset- 0 
F B value= [id=820067730008) 


eae 


E 


ETE 

s 
Pi" 
E 


J 
4 


x 
€: 


Hie 


f?--—-Button wview-—— 
Button btnSare = (B 
brn5ave,seronclickL 
i 


M 


TI 
C 


public void onti you have clicked the Open button 
DisplayToast 


ce 


-— 


Di 
1 
i 
i 
e 
J 
[ru 
ti 
e 
E 
i 
i 
i 


图 A-26 


此 时 ， 有 以 下 几 个 选项 可 以 继续 执行 : 

e Step Into 一 一 按 FS 键 步 进 到 下 一 个 方法 调用 /语句 。 

e Step Over——1Z F6 刍 跳 过 下 一 个 方法 调用 ， 不 进入 此 方法 中 ，。 
e Step Return——f& F7 键 从 已 经 进入 的 方法 中 返回 。 

e Resume Execution 一 一 按 F8 键 继续 执行 。 
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A.2.2 异常 


在 Android 中 进行 开发 时 ， 您 将 会 磁 到 大 量 运 行 时 异常 ， 阻 止 您 的 程序 继续 运 
行 时 异 第 的 例子 包括 以 下 内 容 : 

e "5| HIR] 7 EOS AS) 

e 没有 指定 应 用 程序 所 需 的 权限 

e FAIS Hor it 

图 A-27 展示 了 一 个 应 用 程序 产生 异常 时 的 当前 状态 。 在 这 一 示例 中 ， 我 试图 从 我 的 
应 用 程序 中 发 送 一 条 SMS ÑA. AKARE, iwl. 


运行 。 运 


BE Debug - Source nat found. - Eclipse 
Ble Edit Run Navigate Search Project Refactor Window Help — 


‘Bald i #-O-G-:ao- Et [Ss Debug |i DOMS &j leva 98 Jeva EE 
站 D ¥ 


heey =o] 
a a| G.ERi|s|$-7 
af Thread [41> main] [Suspended [exception SecuntyExcept + 
= Deos&StubsProsy.send Tering String. String, Perdi 
三 SmsManagersend DextMeseage(String, String. String, iG 
= Send$MSLabsendSMSting, Sting) line 3& 
= SendSMSLab.accessS0(SendSMSLab, String, String] lin 
= SendSMSLabS on lick(View) lime: 27 


TernshStubsProey (idz 830067 78264] 
Parcel (id2&30057651760) 
Parcel tid= ERE 


[0] SendSMSLebjeve | = Gmsästub$Pro 


Fource not found, Ain autline is nat available, 


Edit Source Lookup Path... 


[E Console 53 ^«, 2) Tasks | ET auget + aA =| Rana 
Android =| 

(2020-11-30 11:18:11 一 3endS5MSLab] Automatic Target + | I 

[2010-11-30 11:18:12 一 5end5H5bap] Application alre ~ 

Oe t 


: Launching BasicViewst 


图 A-27 


各 式 的 窗口 并 不 能 真正 识别 异常 发 生 的 原因 。 要 寻找 更 多 信息 ， 可 以 在 Eclipse Hix 


F6 BLIAN AJ. Variables 窗口 指出 了 异常 的 原因 ， 如 图 A-28 Pro. ZEAE, MN 
原因 是 缺少 SEND SMS 权限 。 


ich Project Refactor Window — Help 


Bud *-0-«- "5 P P4 sw[EI m [S Debug |e DDMS Revo PË Java EE 


se Variables 55 7. Pa Brrakpoints tte 7 Ce 
Marne Value 

t @ this TnvocationTargetException (idzB320867783568] 

p U excepbon SecurrtyExceptian (1d 2830067 782854) 


ava.lang.SecurirvExceprinn: Sending SMI message: Uzer 10038 does nor have android.permission.SEHND SM3. ^ 


qetException.cl ass aN F Ai E Outline eT 2 I. & I uy uei m m 


图 A-28 
为 了 补救 ， 只 要 在 AndroidManifest.xml 文件 中 添加 以 下 权限 声明 就 行 了 : 


«uses-permission android:name-"android.permission.SEND SMS"/> 
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使 用 Android 模拟 器 


Android 模拟 器 自 带 了 Android SDK, 它 是 一 个 很 有 用 的 工具 , 可 以 帮助 您 测试 应 用 程 
序 而 不 需要 购买 一 台 真 实 设备 。 虽 然 您 应 该 在 部 署 应 用 程序 前 在 真实 设备 上 对 其 进行 彻底 
的 测试 ， 但 模拟 器 还 是 可 以 模仿 真实 设备 的 大 多 数 功 能 。 模 拟 器 是 一 个 在 项 目 开 发 阶段 应 
该 利用 的 非常 方便 的 工具 。 本 附录 提供 了 有 助 于 掌握 Android 模拟 器 的 一 些 常 见 的 提示 和 
技巧 。 


B.1 Android 模拟 器 的 使 用 


正如 在 第 1 章 所 讨论 的 ， 可 以 使 用 Android 模拟 器 ， 通 过 创建 Android Virtual 
Device(AVD) 来 模拟 不 同 的 Android 配置 。 

如 果 想 模拟 真实 的 设备 ， 首 先 使 用 与 真实 设备 相同 的 屏幕 分 辨 率 和 abstracted LCD 密 
度 创建 一 个 AVD( 有 具体 做 法 参见 本 附录 的 “模拟 具有 不 同 屏幕 太 寸 的 设备 ”一 节 )。 然 后 ， 
在 AVD Manager 窗口 中 直接 启动 创建 好 的 AVD( 如 图 B-1 所 示 )。 直接 选择 AVD 并 单 击 
Start 按钮 。 如 果 想 让 模拟 器 显示 的 尺寸 与 真实 设备 的 屏幕 凡 寸 相同 , 则 选中 Scale display to 
real size 选项 ， 并 将 Screen Size (in) 选 项 设 为 真实 设备 的 尺寸 。 输 入 当前 使 用 的 显示 颖 的 
dpi( 如 果 不 知 道 ， 可 以 单 击 ?( 问 号 ) 按 钮 ， 然 后 选择 屏幕 尺寸 和 分 辨 率 )。Android 模拟 器 将 
显示 一 个 接近 真实 设备 的 屏幕 尺寸 。 这 个 选项 十 分 有 用 ， 可 以 用 来 预览 应 用 程序 在 具有 不 
同 屏幕 尺寸 的 实际 屏幕 上 显示 的 效果 。 


Android 4 编程 入 门 经 典 一 一 开发 智能 手机 与 平板 电脑 应 用 


ñ Android Virtual Device Manager 


List of existing Android Virtual Devices located at C'i Usersi Wei-Meng Lee androidhawd 


| AVD Name Target Name Platform API Level 
| v Android2.2 Android 2.2 22 
| v Android2.2 HVGA Android 2.2 2.2 
" Android3.2 Android 3.2 32 
| v^ Android 4.0 Android 4.0 4.0 
~ Android 4.0 Tablet Google APIs (Google Inc.) 4.0 
|" Android 40 WithMaps Google APIs (Google Inc.) 4.0 


uS Launch Options 


| Skim — WVGABÜD (480800) 
Density: High (240) 
V|Scale display tn real size 


E Monitor Density 
Screen Size (ink d 


Monitor dpi: 15 saaa his 
Scale 0.45 Resolution: |1920x1080 = 


| 4 FWipe User data 


w A valid Android Virtual Device. [5] A rd;| ||Launch from snapshot 
X An Android Virtual Device that failed t| | | _|Saweto snapshot 


图 B-1 


注意 : 为 了 使 Android 模拟 器 具有 最 佳 性 能 ， 可 将 屏幕 尺寸 设 为 可 以 允许 的 最 
小 尺寸 。 这 样 可 以 让 模拟 器 的 运行 速度 加 快 。 


或 者 , 在 Eclipse 中 运行 一 个 Android 项 目 时 ， Android 模拟 器 会 自动 启动 来 测试 应 用 程序 。 
可 以 在 Eclipse 中 为 每 一 个 Android 项 目 定 制 Android 模拟 器 , 只 要 选择 Run | Run Configurations. 
选择 左边 位 于 Android Application 下 的 项 目 名 称 ( 如 图 B-2 R) WAEA LAF) Target 
选项 卡 。 在 其 中 可 以 选择 用 来 进行 应 用 程序 测试 的 AVD， 以 及 选择 模拟 不 同 的 场景 ， 如 网 
速 和 网 络 延 迟 。 


Run Configurations 


Create, manage, and run configurations 
Android Application 


Texas 

type Filter text | E Android || | Target ~ [5 Common 
[S| BasicViewst 2 Deployment Target Selection Mlode 
E Databases ©) Manual 
回 Dialog = Automatic 
m3] Emails 
fer] Files 
E Fragment: ANE: Hame Target Mame 
加 HelleWarld J T7] Bndroid 4.0 Android 40 | 
[| ImageSwitcher M Android 4... Google APls (Google l. — 4. ARM (arma... 


E EN. E| Anchoid 4... Google APIs(GoogleL. — 4. ARM (armen... 
a 


| LES 

ET] LecationTracker 

Ej] Metwnrking 

| PassingDeta 

[zr] Shas 

E Sockets Emulator launch parameters: 


加 UsingIntent 
f] UsingPreferences D ee 
Ji Android Unit Test Metweark Latency (None ba | 


J Apache Tomcat —— 
Eclipse Application 


Select a preferred Android Virtual Device for deployment 


k 
Filter mab: hed 3H. of 38 items 


图 B-2 


附录 B 使 用 Android 模拟 器 


B.2 创建 快照 


在 最 新 版 的 AVD Manager 中 ， 可 以 选择 将 模拟 颖 的 状态 保存 到 一 个 快照 文件 中 。 这 样 
下 一 次 启动 模拟 器 时 就 不 会 经 历 漫长 的 启动 时 间 ， 所 以 启动 速度 变 快 。Android 3.0( 及 更 高 
版 本 ) 的 模拟 器 的 局 动 时 间 可 能 长 达 5 分 钟 ， 所 以 这 么 做 尤为 有 用 。 

为 使 用 快照 功能 ， 只 要 在 创建 新 的 AVD 时 ， 选 中 Snapshot Enabled 复 选 枉 ， 如 图 B-3 
所 示 。 

从 Starte TZ £L 2] AVD 时 ， 选中 Launch from snapshot 和 Save to snapshot 复 选 枉 ， 如 
图 B-4 所 示 。 第 一 次 局 动 模拟 器 时 ， 和 它 将 正 营 月 动 。 关 闭 模 拟 器 时 ， 则 会 将 状态 保存 到 人 快 
照 文件 中 。 下 一 次 局 动 模拟 器 时 ， 它 将 立即 显示 ， 并 从 快照 文件 还 原 其 状态 。 


rcu 


uw Create new Android Virtual Device (AVD) 


Name: Android4.0 
Target: Android 4.0 - API Level 14 


CPU/ABE | ARM (armeabi-v7a) 


(& Built-in: Default (WVGA800) - e Launch Options 
© Resolution: | IN Skin: WVGA800 (480x800) 
Density: High (240) 

Scale display to real size 


Hardware: 


Property 

Abstracted LCD density 
Max VM application hea... 
Device ram size 


[ ] Wipe user data 
Launch from snapshot 
Save to snapshot 


| | Override the existing AVD with the same name 


图 B-3 图 B-4 
B.3 模拟 SD 卡 


如 果 创 建 了 一 个 新 的 AVD， 那 么 可 以 模拟 存在 着 一 张 SD 卡 (如 图 B-5 所 示 )。 直 接 输 
入 想 模 拟 的 SD 卡 的 大 小 (在 图 中 的 大 小 为 200MB)。 
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ie Create new Android Virtual Device [AVD] 


Name: Android 4 


Target: Android 4.0 - AFI Level 14 ¥ 


CPLI/ABE | ARM (armeshi-v73) 
SD Card: 

@5iz 700 

m File: 


Snapshot: 
F] Enabled 


| MiB | 


Browse... 


& Built-in: | Default (WV GARDO) * | 


~) Resolution: 


Property 

Abstacted LCD density 

Max VM application hea.. 2 
Device ram size 


Override the existing AVD with the same name 


| Create AVD | | Cancel | 


图 B-5 


或 者 , 可 以 通过 首先 创建 一 个 磁性 映像 并 将 其 附加 到 AVD 上 来 模拟 Android 模拟 器 中 
的 一 张 SD 卡 。mksdcard.exe 实用 程序 (也 位 于 Android SDK 的 tools 文件 夹 下 ) 可 以 用 来 创 
建 一 个 ISO 磁盘 映像 。 下 列 命 令 创 建 一 个 大 小 为 2GB 的 ISO 映像 (还 可 参见 图 B-6): 


mksdcard 2048M sdcard.iso 


— l - —_ 
EN CAWindows\systemi2\cmd.exe | =S | 


E=*And mul i i 4. Ba nid ru id zd kx itun 1s mksdca Pil 


2H48H ei Pil z iz 
B:xünürnid 4d.H«anüraid-zsük*tnols?, 


图 B-6 
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i; Create new Android Virtual Device (AWD) 


Mame: 


Android, d 


Target: [An droid 4.0 - AP] Level 14 - 


CPU/ABI 


SD Card: 


Snapshot 


Skin: 


Hardware: 


ARM (armeabi-7 a) 


A Sire 700 MiB 


iQ File — En Android 40'*andrpid-sdkitool: | Browse... 


[7] Enabled 


@ Built-in: — Default (WVGABOQ) 


(^) Resolution: 


Property 
Abstracted LCD density 


Max VM application hea... 
Device ram size 


Override the existing AVU wath the same name 


图 B-7 


的 规 


附录 B 使 用 Android 模拟 器 


一 旦 创建 了 映像 ， 就 可 以 指定 ISO 文件 的 位 置 了 ， 如 图 B-7 所 示 。 


B4 模拟 具有 不 同 屏幕 尺寸 的 设备 


除了 模拟 SD 卡 外 ， 还 可 以 模拟 具有 不 同 屏幕 大 小 的 设备 。 图 B-8 展示 了 AVD 在 模拟 


HVGA 外 观 ， 其 分 辩 率 是 320 x 480 像素 。 注 意 ， 抽 象 LCD 的 像素 密度 是 1600， 意 思 是 该 
屏幕 的 像素 密度 为 每 英寸 具有 160 个 像素 。 


对 于 您 选择 的 每 一 个 目标 ， 都 有 一 个 可 用 的 外 观 列 表 。Android 文 持 以 下 屏幕 分 辨 率 : 


e HVGA — 320 x 480 

e QVGA — 240 x 320 

e WQVGA400 — 240 x 400 
e WQVGAA32 — 240 x 432 
e WVGA800 — 480 x 800 
e WVGA854 — 480 x 854 


BRS SABES, ADE Ae Ma. BON, np LE BE B-9 所 示 


Create new Android Virtual Device (AVD) 


Name: Android_4 


Target: Android 4.0 - API Level 14 M 


CPU/ABE | ARM (armeabi-v7a) 
SD Card: 
(9. Size: 
C5 File: 
Snapshot: 
| | Enabled 
Skin: 
(& Built-in: HVGA 


C Resolution: 


Hardware: 


Property 

Abstracted LCD density 
Max VM application hea... 
Device ram size 


[| | Override the existing AVD with the same name 


B-8 


当 AVD 启动 后 ， 可 以 看 到 Android 模拟 需 在 模拟 Honeycomb 平板 电脑 ， 如 图 B-10. 


i5 Gd —^- AVD 来 模拟 Samsung Galaxy Tab 10.1. 


I] Create new Android Virtual Device (AVD) 


Name: 


Target: Android 3.2 - API Level 13 hd 


Samsung Galaxy Tab 10.1 


CPU/ABL | ARM (armeabi) 


SD Card: 


Snapshot: 


Skin: 


Hardware: 


© Size: 


D File: 


' | Enabled 


5 Built-in: Default (WXGA) 


© Resolution: 1280 


Property 

Abstracted LCD density 
Keyboard lid support 
Max VM application hea... 


Device ram size 


| | Override the existing AVD with the same name 


e NS 


B-9 
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- LU 
| 353&5amsung Galaky Tab 10.1 


图 B-10 


B.5 模拟 物理 功能 


除了 模拟 具有 不 同 屏幕 大 小 的 设备 之 外 ， 还 可 以 选择 模拟 不 同 的 硬件 功 
个 新 AVD 时 ， 单 击 New… 按 钮 将 显示 一 个 可 用 于 选择 打算 模拟 的 硬件 的 类 型 的 对 话 框 (如 


图 B-11 所 示 )。 


e 
(i. Create new Android Virtual Device [AWC] ag 


Marne: 


Target: 


CPU/ABE 
SD Card: 


Snapshot: 


Android 1 


Android 4.0 - API Level 14 g 


ARM (armeabi-v7 a) 


ig Size 


D File: 


| |Enabled 


i& Built-in: 


(73 Resolution: 


Property 


Abstracted LCD density 


Keyboard lid support na 
Max VM application hea.. 48 
Device ram size 


Override the existing AVD with the same name 


WSVGA - 


E 


| Create AVD || 


Cancel 


图 B-11 


| 
| Property: 


160 Type 
z 
Description: 


4, 
HE o 


: 


Touch-screen support — — 


Ideal size of data partition 司 | 
Ideal size of system partition | 
Accelerometer | the device. 
Audio recording support | 

Audio playback support 

Battery support 

Camera support 

Maximum horizontal camera pixels 
Maximum vertical camera pixels 
DPad support 

GPS support 

GPU emulation 

GSM modem support 

Keyboard support 

LCD backlight 

LCD colar depth 

LCD pixel height 

LCD pixel width 

Hardware Back/Horne keys 

SD Card support 

Proximity support 

Track-ball support LS 
Number of emulated web cameras 司 


| 
antel 


当 创建 一 


附录 B 使 用 Android 模拟 器 


例如 ， 如 果 想 模拟 一 个 没有 触摸 屏 的 Android ix 


备 ， 可 以 选择 Touch-screen support 属性 并 单 击 OK 按 si | 
钮 。 回 到 AVD 对 话 框 ， 将 该 属性 值 从 yes 变 为 no( 如 ees : 
图 B-12 所 示 )。 i : 


这 将 创建 一 个 不 带 有 触摸 屏 支 持 的 AVD( 也 就 是 
说 ， 用 户 不 能 使 用 鼠标 在 屏幕 上 单 击 )。 
还 可 以 使 用 Android 模拟 器 来 模拟 位 置 数据 。 第 


9 章 详 细 讨 论 过 这 一 点 。 图 B-12 
键盘 快捷 键 


Android 模拟 器 支持 多 个 键盘 快捷 键 ， 可 以 使 您 模仿 一 个 真实 手机 的 行为 。 以 下 列表 
展示 了 可 与 模拟 器 一 起 使 用 的 一 组 快捷 键 : 

e Esc 一 返回 

e Home 一 主屏 幕 

e F2 一 切换 上 下 文敏 感 菜 单 

e 下 3 一 通话 记录 

e F4 一 结束 通话 按钮 

e F7 一 电源 按钮 

e F5 一 搜索 

e F6 一 切换 跟踪 球 模式 

e 上 8 一 切换 数据 网 络 (3G) 

e _ CtrlHF5 一 提高 铃声 音量 

e CtrlHF6 一 降低 铃声 音量 

e _ CtrlHF1LCtrHF12 一 切换 方 回 

例如 , 通过 按 下 Ctl+F11 组 合 键 , 可 以 将 模拟 器 的 方向 改 为 纵向 模式 (如 图 B-13 所 示 )。 


E) 5554:Android 40 =|- — 


Parm pm rn PLUR n m n Pm 
pn n pem er] er o rer m m 73 
Be Pn nnd md. 


图 B-13 
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使 您 的 开发 更 有 效率 的 一 个 有 用 的 诀 宕 就 是 在 开发 过 程 中 一 直 使 Android 模拟 器 处 于 
运行 状态 一 一 不 要 关闭 和 重启 它 。 因 为 模拟 器 启动 要 花费 时 间 ， 当 您 在 调试 应 用 程序 时 ， 
最 好 让 它 一 直 运 行 着 。 


B.6 给 模拟 器 发 送 SMS 消息 


使 用 Eclipse 中 可 用 的 Dalvik Debug Monitor Service(DDMS) 工 具 或 者 Telnet 客户 端 ， 
可 以 模拟 发 送 SMS 消息 到 Android ET d o 


注意 : Telnet 客户 端 不 是 Windows 7 的 默认 安装 项 。 要 安装 它 ， 可 在 Windows 
命令 提示 符 下 输入 以 下 命令 行 : 


pkgmgr /iu: "TelnetClient " 


现在 看 一 看 在 Telnet 中 如 何 做 到 这 一 点 。 首 先 ， 确 保 Android 模拟 器 正在 运行 。 为 了 
Telnet 到 模拟 器 ， 需 要 知道 模拟 器 的 端口 号 。 这 可 以 通过 查看 Android 模拟 器 窗口 的 标题 
栏 获 得 。 端口 号 通常 以 5554 开始 , 每 一 个 后 续 模 拟 器 的 端口 号 以 2 递增 , 例如 5556、5558 
等 。 假 定 当前 有 一 个 Android 模拟 器 在 运行 ， 那 么 可 以 使 用 以 下 命令 Telnet 到 它 上 面 (使 用 
您 的 模拟 器 的 实际 端口 号 替换 5554): 


C:\telnet localhost 5554 


要 给 模拟 器 发 送 一 条 SMS 消息 ， 可 使 用 
以 下 命令 : 


sms send +1234567 Hello my friend! 


sms send 命令 的 语法 如 下 所 示 : 


sms send <phone number> <message> 


图 B-14 展示 了 模拟 器 正在 接收 刚刚 发 
送 的 SMS 消息 。 

除了 使 用 Telnet 发 送 SMS 消息 之 外 ,还 
可 使 用 Eclipse 中 的 DDMS 透视 图 。 如 果 
DDMS 透视 图 在 Eclipse 中 没有 显示 ， 可 以 
单 击 Open Perspective 按钮 (如 图 B-15 所 示 ) 
并 选择 Other ANE. 


Camera 


图 B-14 
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图 B-15 


选择 DDMS 透视 图 (如 图 B-16 所 示 ) 并 单 击 OK 按钮 。 

DDMS 透视 图 显示 之 后 ， 就 可 以 看 到 Devices 选项 卡 ( 如 图 B-17 所 示 )， 里 面 显示 了 当 
前 正在 运行 的 模拟 器 的 列表 。 选择 一 个 打算 回 其 发 送 SMS YH SU ae SE, 在 Emulator 
Control 选项 卡 的 下 面 ， 将 看 到 Telephony Actions 部 分 。 在 Incoming number 字段 中 ， 输 入 
一 个 任意 电话 号 码 并 选中 SMS Fidei. HA — AETHER Send 按钮 。 

现在 ， 选 中 的 模拟 器 将 收 到 一 条 传 入 的 SMS TH BL. 

如 果 同 时 有 多 个 AVD 运行 ， 可 以 使 用 模拟 器 的 端口 号 作为 电话 号 码 在 每 一 个 AVD 之 
间 发 送 SMS 消息。 例如 ， 如 果 您 有 分 别 运行 在 端口 号 5554 和 5556 上 的 两 个 模拟 嚣 ， 它 们 
的 电话 号 个 将 分 别 是 5554 和 5556. 


CH DDMS - BasicViewsl/res/values/strings.xml - Eclipse 
File Edit Refactor Run Navigate Search Project 
| IHS: 8B od: 


emulator-5554 
system process 
com.android.systemut 
com.android.inputmethod.latin 
com.android.phone 


laa CVS Repository Exploring | com.android.launcher 

G Database Debug | com.android.settings 

android.process.acore 
" 


(o Database Development 


@ Emulator Control 53 
Telephony Status 


# | | i | 
Gd Java Browsing dem a 


1e! ava Type Hierarchy 
& JavaScript Telephony Actions 

++ IPA Incoming number: «1234567 
A Pixel Perfect 3 © Voice 

e Planning | e SMS 

4 Plug-in Development 
EB Remote System Explorer 


Ls Reenurce 


Message: Hello my friends! 
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B.7 FEW 


除了 发 送 SMS 消息 到 模拟 器 , 还 可 以 使 用 Telnet 客户 端 给 模拟 器 打 电 话 。 直 接 使 用 以 
下 命令 就 可 以 做 到 这 一 点 。 
要 Telnet 到 模拟 器 ， 使 用 下 列 命 令 (使 用 您 的 模拟 器 的 实际 端口 号 替换 5554): 


C:\telnet localhost 5554 


要 给 模拟 器 打 电 话 ， 使 用 下 列 命 令 : 


gsm call +123456/7 


gsm send 命令 的 语法 如 下 所 示 : 

gsm call <phone number> 

图 B-18 展示 了 模拟 器 收 到 一 个 来 电 。 

与 发 送 SMS 消息 类 似 , 也 可 以 使 用 DDMS 透视 图 来 给 模拟 器 打 电 话 。 图 B-19 展示 了 
如 何 使 用 Telephony Actions 部 分 来 打 电 话 。 

还 可 以 使 用 端口 号 作为 电话 号 码 在 AVD 之 间 打 电话 。 


r 
&^ S534 ndraid 4.0 DDMS - BasicViews Léres/values/strings.xml - Eclipse 


Ele Edit Refactor Run  Mavigate Search Project 


D- E Sa Bnd- 
f” Devices 53 ~ m 


+1234567 


ame a 
«zB emulator-5554 nline 


system process 
com,.android.systermui 
com.android.inputmethod Jatin 


INCOMING CALL 


com.android. phone 
corn.androidlauncher 
cnm.ancdroid.settings 
ancdroic.process,acore 


Telephony Status 


Telephony Actions 

Incoming number «1234507 
(a Voice 

(©) 3MS 


Message: Hello my friends! 


| Call | Hang Up 


图 B-18 图 B-19 


B.8 ”从 模拟 器 中 传 入 / 传 出 文件 


偶尔 ， 您 也 许 需 要 从 模拟 器 中 传 入 / 传 出 文件 。 使 用 DDMS 透视 图 是 最 容易 的 方法 。 
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A DDMS 透视 图 中 选择 模拟 器 (或 者 设备 ， 如 果 您 有 一 个 连接 到 计算 机 的 真实 的 Android 
设备 的 话 ) 并 单 击 File Explorer 选项 卡 来 查看 它 的 文件 系统 (如 图 B-20 Pras). 


Kr DOMS - BasicViewsl/res/values/strings.xml - Eclipse 
File Edit Refactor Run Navigate Search Project Window Help 
mi ni tue GQ 4" 5-orf'-"- Ei & Java $5 Debug 


@ Emulator Control H ` -= O4 Threads | @ Heap @ Allocation Tracker || — File Explorer Ei > 


Telephony Status 


Voice: hom ~ | Speed: (Ful ~ zi + > netearn2develop.Nebworking 2011-11-13 


= > > net learnZédevelop Sockets 2011-11-30 
Data: [home =| Latency: | None -| , EE net Jearn2develop.Usinglntent 2011-11-18 
4 (= netlearnzdevelop.UsingPreferences 2011-11-22 
b gb 2001-11-22 Q | 
Incoming number; «1234567 a © shared prefs 2001-31-22 of | 
® Voice | appPreferences.xml 193 2011-11-22 0: 

^j SMS =| met.learnzdevelop.UsingPreferences preferences.xml 165 2011-11-22 

t G& dontpanic #011-10-20 

po E drm 2011-10-20 

» fe local 2011-10-20 


Telephony Actions 


Hella my friends! 


£D LogCat E Console 器 EW Ba | "mE-ri- 
Android — 


[2811- 12- a5 16:13: 36 - SDK Manager] Found SDK Platform Android 4.8, API 14, revision 1 
[2811-12-85 16:13:36 - SDK Manager] Found ARM EABI w7a System Image, Android API 14, revision 1 
[2811-12-85 16:13:36 - SDK Manager] Found Samples for SDK API 7, revision 1 
[2811-12-85 16:13:36 - SDK Manager | Found Samples for SOK API 8, revision 1 
[2811-12-65 16:13:36 - 50K Manager | Found Samples for 5DK API 9, revision 1 (Obsolete) 
[2811-12-85 16:13:36 - SDK Manager] Found Samples for SDK API 18, revision 1 
[2811-12-85 16:13:36 - SDK Manager] Found Samples for SDK API 11, revision 1 
[2811-12-85 16:13:36 - 5DK Manager] Found Samples for SDK API 12, revision 1 
[2811-12-85 16:13:36 - 5DK Manager] Found Samples for SDK API 13, revision 1 
[2811-12-85 16:13:36 - SDK Manager] Found Samples for SDK API 14, revision 1 

4 


m amm om mEGD OG OmU rr n a a n RC 3 RR TR RR RS VERRE — 


mni Android SDK Content Loader 


图 B-20 


( 注意 : 当 使 用 adb.exe 实用 工具 从 模拟 器 中 拖 出 或 拖 入 文件 时 ， 确 保 只 有 一 个 
AVD 在 运行 


图 B-20 中 高 亮 显示 的 两 个 按钮 可 用 于 从 模拟 器 中 拖 出 或 加 模拟 器 中 拖 入 一 个 文件 。 

或 者 ， 还 可 以 使 用 Android SDK 自 带 的 adb.exe 实用 工具 来 从 模拟 器 中 拖 出 或 拖 入 文件 。 
这 个 实用 工具 位 于 <Android SDK Folder>\platform-tools\ 文 件 夹 下 。 

要 从 已 连接 的 模拟 器 /设备 上 复制 文件 到 计算 机 上 ， 可 使 用 以 下 命令 : 


adb.exe pull <source path on emulator> 


图 B-21 展示 了 如 何 从 模拟 器 中 提取 一 个 XML 文件 并 将 其 保存 到 您 的 计算 机 上 。 


| BB CAWindows\system32\cmd.exe 


kE:*Hndroid 4.BH*«android-sdk*platform-tools»^adb.exe pull ^data^data^net.learnzZdeve 
lop.UsingPrefer ences/s hared _prefs/“appPr eferences. xm 

A KB^s (168 bytes in 6.14255 

E: 


;*ündroid 4.BH*«android—-sdk*platform-tools? 


图 B-21 


要 将 文件 复制 到 已 连接 的 模拟 费 / 设 备 上 ， 可 使 用 以 下 命令 : 


adb .exe push «filename» «destination path on emulator> 


图 B-22 中 的 命令 复制 了 位 于 当前 目录 下 的 NOTICE .txt 文件， 并 将 其 保存 在 模拟 器 的 
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/data/data/net. eee UsingPreferences/shared prefs 文件 夹 下 。 


EN C:\Windows\system32\cmd.exe 


E:*Hndroid 4.6\android-sdk\platform-toolssadhb.exe push NOTICE. txt /data/t 
- learn? meted Us ingPre eferences/s ae 
117 KB/s €366627 bytes in 3.853z 


E:*findroid 4.6 .android-sdk\platform—too ls > 


图 B-22 


WE BEE BULA IB BOC EAA, BY DAE PAT shell 选项 的 adb.exe 实用 工具 ， 
如 下 所 示 : 


adb.exe shell 


图 B-23 展示 了 如 何 利用 chmod 命令 修改 NOTICE.txt 文件 的 权限 。 
m» C:\Windows\system32\cmd.exe - adb.exe shell | 


E:*hHndroid 4. m«android südk*platform tonols»adh.exe on Md 

# cd data^data 

cd data^data 

H cd net.learnzZdevelop.lsingPreferences^/shared prets 

En lt .learnZdeuelop.lizingPreferencezs^/shared prefs 
pu 


pwd 

poar ad ‘data/net . lea sa acca np.lizingPreferences^/zshared, pref z 
od 777 MOTICE.tx 

chmod 777 HOTICE. txt 

# ls -al 


lg al 
—PWXFuUxrFux Poot "DO 366627 2611-11-29 13:25 NOTICE. txt 
PWS app. 48 app. 48 188 2811-11-22 83:13 appPrefere 


s.xml 
—rw-rwu---- app_48 app. 48 165 2611-11-22 W2:52 net. le aens Ai + op.UWsingPr 
eferences_preferences.xml 
It 


图 B-23 


使 用 adb.exe 实用 工具 ， 可 以 对 Android 模拟 器 发 出 Unix 命令 。 
B9 重 置 模拟 器 


有 时 候 会 想 把 应 用 程序 安装 到 一 个 全 新 的 AVD 中 。 例 如 ， 可 能 以 前 安装 的 其 他 应 用 
程序 会 影响 当前 应 用 程序 (例如 ， * SMS 拦截 应 用 程序 可 能 会 拦截 发 送 给 您 的 应 用 程序 
的 SMS YAU). JIN, BEAT LAM Settings 应 用 程序 中 番 载 每 个 应 用 程序 ， 也 可 以 探 除 模拟 
髓 的 镜像 ， 使 其 还 原 到 初始 状态 (这 是 更 简单 的 方法 )。 

MAREE] Android 模拟 器 上 的 应 用 程序 和 文件 都 保存 在 一 个 名 为 userdata-qemu.img 
的 文件 中 ， 此 文件 位 于 C:\Users\<username>\.android\avd\<avd name>.avd 文件 来 下 。 例如 ， 
有 一 个 名 为 AndroidTabletWithMaps 的 AVD ， 因 此 userdata-qemu.img 文件 就 位 于 
C:\Users\Wei-Meng AAA ies a LEF. 

fy) FERRE BI 28 Vk R RRRS (AH BY E), 只 要 删除 userdata-qemu.img 文件 就 行 了 。 
以 前 在 这 个 AVD 上 安装 的 所 有 应 用 程序 都 将 被 清除 
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附录 


练习 答案 


本 附录 包括 了 各 章 最 后 的 练习 的 答案 。 


第 1 章 答案 


1. AVD 指 的 是 Android 虚拟 设备 。 它 代表 了 一 个 Android 模拟 器 ， 可 以 模拟 一 个 实际 
Android 设备 的 特定 配置 。 

2. android:versionCode 属性 用 来 以 编程 方式 检查 一 个 应 用 程序 是 否 可 以 被 升级 。 它 应 
当 包 含 一 个 顺序 号 (更 新 的 应 用 程序 的 号 码 应 该 比 老 版 本 的 设置 得 要 高 )。 
android:versionName 属性 主要 用 来 显示 给 用 户 。 它 是 一 个 字符 串 ， 如 1.0.1。 

3. string.xml 文件 用 来 存储 应 用 程序 中 的 所 有 字符 串 和 常量 。 这 使 得 您 可 以 很 容易 地 通 
过 替换 这 些 字 符 串 并 重新 编译 应 用 程序 来 本 地 化 您 的 应 用 程序 。 


第 2 章 答 案 


1. Android 操作 系统 将 显示 一 个 对 话 框 ， 用 户 可 以 从 中 选择 他 们 想 使 用 的 那 一 个 活动 。 
2. 使 用 如 下 代码 : 
Intent 1 = new 


Intent (android.content.Intent.ACTION VIEW, 


Uri.parse("http://www.amazon.com")); 
startActivity(1); 


3. (Ex Eme +, AAR EA EAA: 动作 、 数 据 、 类 型 和 类 别 。 
4. Toast 类 用 来 回 用 户 显 示 和 警报， 并 在 几 秒 钟 后 消失 。NotificationManager 类 用 来 在 设 
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备 的 状态 栏 上 显示 通知 。 由 NotificationManager 类 显示 的 警报 是 持久 性 的 ， 只 能 通 
过 用 户 的 选中 操作 来 撤销 。 


. 可 以 使 用 XML 文件 中 的 <ffagment> 元 素 或 者 使 用 FragmentManager 类 和 FragmentTrans- 


action 类 在 活动 中 动态 添加 /删除 碎片 。 


. 活动 的 碎片 的 一 个 主要 区 别 是 ， 当 活动 进入 后 台 时 ,会 被 放 到 back stack 上 。 这 样 ， 


当 用 户 按 Back 按钮 时 ， 活 动 可 以 恢复 。 与 之 相反 ， 碎 片 在 进入 后 台 时 不 会 被 目 动 
放 到 back stack E- 


第 3 章 答案 


第 4 


. dp 单位 是 与 密度 无 关 的 ，1dp 相当 于 一 个 160dpi 的 屏幕 上 的 一 个 像素 。px 单位 对 


应 于 屏幕 上 的 实际 像素 。 一 般 应 当 使 用 dp 单位 ， 因 为 它 可 以 使 活动 在 人 不同 屏 右 大 
小 的 设备 上 都 可 以 正确 地 缩放 。 


. 随 着 不 同 屏 莫大 小 的 设备 的 出 现 ， 使 用 AbsoluteLayout 使 得 您 的 应 用 程序 在 里 设备 


应 用 时 很 难保 持 一 致 的 外 观 和 体验 。 


. 当 一 个 活动 被 终止 或 转 入 后 台 时 , 将 触发 onPause0 事 件 。onSaveInstanceState0 事 件 


与 onPause0 事 件 类 似 ,除了 它 不 总 是 被 调用 , 例如 当 用 户 按 下 Back 按钮 来 终止 活 
动 时 就 不 会 调用 。 
3 个 事件 是 onPauseO0、onSaveImstanceState0 和 onRetainNonConfigurationInstance(). 
- 般 使 用 onPauseO0 方 法 来 保存 活动 的 状态 ， 因 为 在 活动 将 要 销毁 时 总 是 会 调用 这 
个 方法 。 但 是 ， 对 于 屏幕 方向 的 变化 ， 使 用 onSaveInstanceState0 方 法 将 活动 的 状 
态 ( 例 如 用 户 输 入 的 数据 ) 保 存 到 一 个 Bundle 对 象 中 更 加 方便 。onRetainNonConfig- 
UrationInstance(0) 方 法 对 于 临时 保存 数据 (例如 从 Web 服务 下 载 的 图 像 或 文件 ) 十 分 
有 用 ， 这 些 数据 可 能 太 大 ， 不 适合 放 到 一 个 Bundle 对 象 中 。 


. 在 Action Bar 中 添加 动作 项 类 似 于 为 选项 麻 单 创建 表单 项 一 一 只 须 人 处理 onCreate- 


OptionsMenu0 事 件 和 onOptionsItemSelectedO 事 件 。 


= Ar = 
Bez 


1. 应 该 检验 每 一 个 RadioButton 的 SCheckedO0 方 法 来 确定 其 是 否 被 选中 。 


. 可 以 使 用 getResources0 方 法 。 
. 以 下 代码 片段 用 于 获取 当前 日 期 : 


//--get the current date-- 

Calendar today = Calendar.getInstance(); 
yr = today.get (Calendar.YEAR); 

month = today.get(Calendar.MONTH); 

day = today.get(Calendar.DAY OF MONTH); 


附录 C 练习 答案 


showDialog(DATE DIALOG ID); 


4. 3 个 专用 健 片 是 ListFragment, DialogFragment 和 PreferenceFragment. ListFragment 
对 于 显示 一 个 项 目 列表 很 有 帮助 ， 例 如 RSS 新 闻 列 表 。DialogFragment 允许 以 模 态 
方式 显示 一 个 对 话 杠 窗口， 这 样 用 户 必须 做 出 回应 ， 然 后 才能 继续 使 用 应 用 程序 。 
PreferenceFragment 显示 一 个 包含 应 用 程序 首选 项 的 窗口 , 允许 用 户 直 接 在 应 用 程序 
中 编辑 首选 项 。 


第 5 章 管 案 


l. ImageSwitcher 可 以 使 图 像 动 画 显 示 。 您 可 以 在 图 像 显 示 时 以 及 被 男 一 幅 图 像 蔡 换 
时 动画 显示 它 。 

2. 两 个 方法 是 onCreateOptionsMenu0 和 onOptionsItemSelected(). 

3. 两 个 方法 是 onCreateContextMenu0 和 onContextItemSelected(). 

4. 要 防止 局 动 设备 的 Web D Vas, 需要 实现 WebViewClient 类 并 重 写 shouldOverride- 
UrlLoading() 77 17; . 


第 6 章 答案 


1. 可 以 使 用 PreferenceActivity 类 完成 。 
2. 方法 名 称 是 getExternalStorageDirectory(). 
3. 权限 是 WRITE EXTERNAL STORAGE。 


第 7 章 答 案 


1. 代码 如 下 所 示 : 


Lüursor cC}; 
if (android.os.Build.VERSION.SDK INT <11} { 

//---before Honeycomb--- 

C — managedQuery(allContacts, projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
new String[] {"tjack"}, 
ContactsContract.Contacts.DISPLAY NAME + " ASC"); 

} else { 

//---Honeycomb and later--- 
CursorLoader cursorLoader - new CursorLoader( 
this, 
allContacts, 
projection, 
ContactsContract.Contacts.DISPLAY NAME + " LIKE ?", 
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new String[] {"sjack"}, 
ContactsContract.Contacts.DISPLAY NAME + " ASC"); 
C = cursorLoader.loadInBackground(); 


} 


. 方法 是 getTypeO0、onCreate0、queryO、insert0、delete0 和 update(). 


3. JA BAS: 


«provider android:name-"BooksProvider" 
android:authorities-"net.learn2develop.provider.Books" /» 


Im ^u 
Bez 


. 可 以 以 编程 方式 从 Android 应 用 程序 中 发 送 SMS 消息 ， 也 可 以 以 应 用 程序 的 名 义 


调用 内 置 的 Messaging 应 用 程序 来 发 送 SMS 信息 。 


2. 两 个 权限 是 SEND SMS fil RECEIVE SMS. 
3. 广播 接收 者 应 该 触发 一 个 将 由 活动 接收 的 新 意图 。 活 动 应 该 实现 另 一 个 


BroadcastReceiver 来 侦 听 这 个 新 的 意图 。 


LAE 


AN} 


. 可 能 的 原因 如 下 所 示 : 


e 没有 JInternet 连接 
e <Uses-library> 元 素 在 AndroidManifest.xml 文件 中 的 位 置 错 误 


e AndroidManifest.xml 文件 中 缺少 INTERNET 权限 


. 地 理 编码 是 将 一 个 地 址 转换 成 其 坐标 (经 度 和 纬度 )。 反 癌 地 理 编码 是 将 一 对 位 置 华 


标 转 换 成 一 个 地 址 。 


. 两 个 位 置 服务 提供 商 如 下 所 示 : 


e LocationManager.GPS PROVIDER 
e LocationManager. NETWORK PROVIDER 


. 方法 是 addProximityAlert(). 


10 章 答 案 


声明 INTERNET 许可 。 
这 些 类 为 ISONArray 和 JSONObject. 
该 类 为 AsyncTask。 


附录 C 练习 答案 
第 11 章 答 案 


1. 这 是 因为 服务 和 主 调 活动 运行 在 同一 个 进程 上 上。 如果 服 务 是 长 时 间 运 行 的 ， 那 么 需 
要 在 一 个 单独 的 线程 上 运行 它 ， 这 样 才 不 会 阻塞 活动 。 

2. IntentService 类 与 Service 类 相似 ， 只 不 过 前 者 在 一 个 单独 的 线程 上 运行 任务 ， 并 且 
当 任 务 结束 执行 时 可 以 目 动 停止 服务 。 

3.3 个 方法 是 doInBackground()、 onProgressUpdate0 和 onPostExecute(). 

4. 服务 可 以 广播 一 个 意图 ， 而 活动 可 以 使 用 一 个 IntentFilter 类 来 注册 一 个 意图 。 

5. 推荐 的 方法 是 创建 一 个 类 来 继承 AsyncTask 类 ， 这 可 以 确保 UI 以 一 种 线程 安全 的 


第 12 音 答 案 


1. 在 AndroidManifest.xml 文件 中 使 用 minSdk Version 属性 来 指定 所 需 的 Android 最 低 


版 本 。 
2. 可 以 使 用 Java SDK 的 keytool.exe 实用 工具 ， 也 可 以 使 用 Eclipse 的 Export 功能 来 
生成 证 书 。 


3. 转 到 Settings 应 用 程序 并 选择 Security 项 。 选 中 Unknown sources 项 。 


